Returns a list of categories without subcategories, with support for pagination and filtering by active status. 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/categories
• Summary: Retrieve categories
• Description: Returns a list of categories without subcategories, with support for pagination and filtering by active status. 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.

{
  "data": [
    {
      "attributes": {},
      "cover_url": "string",
      "full_path_name": [
        "string"
      ],
      "full_uri_translations": {},
      "id": "string",
      "name": "string",
      "parent_id": "string",
      "redirects": {},
      "slug_translations": {},
      "sort_order": 0,
      "status": "string",
      "sub_categories": [
        {
          "attributes": null,
          "cover_url": null,
          "full_path_name": null,
          "full_uri_translations": null,
          "id": null,
          "name": null,
          "parent_id": null,
          "redirects": null,
          "slug_translations": null,
          "sort_order": null,
          "status": null,
          "sub_categories": null,
          "uri": null
        }
      ],
      "uri": "string"
    }
  ],
  "page": 0,
  "total": 0,
  "total_pages": 0
}

{
  "message": "string"
}

{
  "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/categories
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Categories
• OpenAPI summary: Retrieve categories