Get full category tree for an app
Retrieves the complete hierarchical category structure for a given app Deprecated. Use https://graphql.enad.io instead.
/api/v1/omni/:app_id/:store_group/:market/:locale/category-tree- API
- Shopper
- OpenAPI
- shopper-api
- Updated
- Apr 26, 2026
shopper-api:GET:/api/v1/omni/:app_id/:store_group/:market/:locale/category-tree
Retrieves the complete hierarchical category structure 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/category-tree - Summary: Get full category tree for an app
- Description: Retrieves the complete hierarchical category structure 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 |
| locale | path | Yes | string | Locale for translations |
| market | path | Yes | string | Market |
| store_group | path | Yes | string | StoreGroup |
Request body
Not documented in the OpenAPI contract.
Responses
| Status | Description | Content |
|---|---|---|
| 200 | OK | application/json (object[]) |
| 400 | Bad Request | application/json (object) |
| 500 | Internal Server Error | application/json (object) |
200 - object[]
Type: object[]
Generated example (synthetic):
[
{
"data": [
{
"attributes": {},
"cover_url": "string",
"full_path_name": [],
"full_uri_translations": {},
"id": "string",
"name": "string",
"parent_id": "string",
"redirects": {},
"slug_translations": {},
"sort_order": 0,
"status": "string",
"sub_categories": [],
"uri": "string"
}
]
}
]400 - 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/category-tree - Operation ID: Not documented in the OpenAPI contract.
- OpenAPI tag: Categories
- OpenAPI summary: Get full category tree for an app