Fetch a collection by URI
Fetch a single collection by its URI for a given app Deprecated. Use https://graphql.enad.io instead.
/api/v1/omni/:app_id/:store_group/:market/:locale/collections/uri/:uri- API
- Shopper
- OpenAPI
- shopper-api
- Updated
- Apr 26, 2026
shopper-api:GET:/api/v1/omni/:app_id/:store_group/:market/:locale/collections/uri/:uri
Fetch a single collection by its URI for a given app Deprecated. Use https://graphql.enad.io instead.
API ownership
- API family: Shopper API
- Best for: Public storefront catalog reads and shopper-facing product discovery.
- Prefer Search API for: New product discovery, facets, autocomplete, and other search-heavy storefront flows.
- Do not use from: Trusted admin integrations that create, update, or delete merchant-owned data.
- Guide route: /apis/shopper/latest
The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.
Operation
- Method:
GET - Path:
/api/v1/omni/:app_id/:store_group/:market/:locale/collections/uri/:uri - Summary: Fetch a collection by URI
- Description: Fetch a single collection by its URI for a given app Deprecated. Use https://graphql.enad.io instead.
- OpenAPI contract: shopper-api
- Operation ID: Not documented in the OpenAPI contract.
Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| app_id | path | Yes | string | App ID |
| uri | path | Yes | string | Collection URI |
| locale | path | Yes | string | Alpha 2 country code. e.g se |
| market | path | Yes | string | Market slug. e.g se |
| store_group | path | Yes | string | Store group slug |
| page | query | No | integer | Page number (default: 1) |
| per_page | query | No | integer | Items per page (default: 20, max: 20) |
| only_active | query | No | boolean | Filter only active products |
| include_child_collection_products | query | No | boolean | Fetch all child categories products as well |
Request body
Not documented in the OpenAPI contract.
Responses
| Status | Description | Content |
|---|---|---|
| 200 | Collection with paginated products | application/json (object) |
| 400 | Invalid request | application/json (object) |
| 404 | Collection not found | application/json (object) |
| 500 | Internal server error | application/json (object) |
200 - object
Collection With Paginated Products Response
| Property | Type | Required | Details |
|---|---|---|---|
data | object | No | - |
Collection With Paginated Products
| Property | Type | Required | Details |
|---|---|---|---|
children | object[] | No | - |
id | string | No | - |
parent_id | string | No | - |
products | object | No | - |
title | string | No | - |
uri | string | No | - |
Collection
| Property | Type | Required | Details |
|---|---|---|---|
children | object[] | No | - |
id | string | No | - |
parent_id | string | No | - |
title | string | No | - |
uri | string | No | - |
Paginated Product With Short Related Product List
| Property | Type | Required | Details |
|---|---|---|---|
data | object[] | No | - |
page | integer | No | - |
total | integer | No | - |
total_pages | integer | No | - |
{
"data": {
"children": [
{
"children": [],
"id": "string",
"parent_id": "string",
"title": "string",
"uri": "string"
}
],
"id": "string",
"parent_id": "string",
"products": {
"data": [
{
"attributes": null,
"brands": null,
"categories": null,
"collections": null,
"created_at": null,
"custom_fields": null,
"description": null,
"files": null,
"html_description": null,
"html_short_description": null,
"id": null,
"images": null,
"in_stock": null,
"is_active": null,
"meta_description": null,
"meta_title": null,
"product_name": null,
"product_number": null,
"rank": null,
"redirects": null,
"related_products": null,
"short_description": null,
"slug": null,
"slug_translations": null,
"status": null,
"tags": null,
"third_party_links": null,
"updated_at": null,
"variants": null,
"videos": null
}
],
"page": 0,
"total": 0,
"total_pages": 0
},
"title": "string",
"uri": "string"
}
}400 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
message | string | No | - |
Generated example (synthetic):
{
"message": "string"
}404 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
message | string | No | - |
Generated example (synthetic):
{
"message": "string"
}500 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
message | string | No | - |
Generated example (synthetic):
{
"message": "string"
}Contract identity
Use these fields to confirm you are implementing the intended endpoint contract.
- API family: Shopper API
- Method:
GET - Path:
/api/v1/omni/:app_id/:store_group/:market/:locale/collections/uri/:uri - Operation ID: Not documented in the OpenAPI contract.
- OpenAPI tag: Collections
- OpenAPI summary: Fetch a collection by URI