Get brand categories

You can filter a catalog by category such as grocery, beauty, health and wellness, etc. Categories have a Universal Unique Identifier (UUID). See how to Manage catalog.

The following endpoint retrieves a list of all categories with their identifiers:

Endpoint	Purpose
`GET {URI}//brandCategories`	Get all brand categories

The following example shows the payload for brand categories:

{
  "brandCategories": [
    {
      "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "description": "string"
    }
  ]
}

The following payload example shows all brand categories available in this platform using GET {URI}//brandCategories endpoint:

{
  "brandCategories": [
    {
      "identifier": "48e88ff6-4b69-4da5-a1e7-b1c401d73c5c",
      "description": "Grocery"
    },
    {
      "identifier": "55529c83-f37d-4e1c-9c87-6f11b4622441",
      "description": "Beauty"
    },
    {
      "identifier": "06472040-8fb1-4767-b8d4-ccfcd467a720",
      "description": "For The Home"
    },
    {
      "identifier": "b9ff6795-12ba-4b46-9edc-e37a964ae747",
      "description": "Health & Wellness"
    },
    {
      "identifier": "a8940733-26b4-4457-829f-8c12d38dd9c7",
      "description": "Pet Care"
    },
    {
      "identifier": "f83ec3c6-86e3-4316-9419-1beeae7895d1",
      "description": "Prepaid & Cash Transfer"
    },
    {
      "identifier": "07a20c2b-2ca7-4aa4-a99f-e7c6c6f87cd2",
      "description": "Dining"
    },
    {
      "identifier": "67e5e327-4c96-4dd4-a60e-3ca6c2205da4",
      "description": "Entertainment"
    },
    {
      "identifier": "b663267f-8b0c-4caa-acbc-40c87983d31e",
      "description": "Fashion"
    },
    {
      "identifier": "0b72f0df-d480-4cab-85c0-2eeb693bae28",
      "description": "Specialty"
    },
    {
      "identifier": "20122ee3-ed36-4259-bb3c-a2072cfd8c93",
      "description": "Travel"
    },
    {
      "identifier": "e78a872e-ac28-41b7-bccf-737aa5cc7cab",
      "description": "Donation"
    },
    {
      "identifier": "b749f361-05b6-41a8-9d4e-477f52f09f5e",
      "description": "Auto Care"
    },
    {
      "identifier": "166dbd79-ebef-4f26-8e30-b79077c1d6c4",
      "description": "Digital Media"
    },
    {
      "identifier": "3cf07af1-d84c-4b09-b1be-c26e52f9ed25",
      "description": "Sporting Goods"
    },
    {
      "identifier": "ed828e67-be4f-4e84-8a7d-3eb6b1054c89",
      "description": "Kids & Baby"
    },
    {
      "identifier": "f8379dbf-9215-47ba-b866-5d16e10ac922",
      "description": "Technology"
    },
    {
      "identifier": "95bd9939-e446-42ed-93cf-918d07054fe5",
      "description": "Self Care"
    },
    {
      "identifier": "7a7dd13e-710c-41fc-a0b5-1c7c51e74095",
      "description": "Fuel"
    },
    {
      "identifier": "e1a13abc-be00-4ff3-bb19-36d68b57cda0",
      "description": "Marketplaces & Department Stores"
    },
    {
      "identifier": "b0708bc7-7a2d-411e-93d6-6b25abd927c6",
      "description": "Beverage"
    },
    {
      "identifier": "8abd9707-f652-49e6-9f44-15fad04bff33",
      "description": "Gaming"
    }
  ]
}

Here's an example payload for when you receive an error:

{
  "timestamp": "2025-02-21T23:23:13.930Z",
  "requestId": "string",
  "path": "string",
  "httpCode": 0,
  "httpPhrase": "string",
  "i18nKey": "string",
  "message": "The error message will show here for error codes ",
  "errors": [
    {}
  ]
}

The possible response codes for this endpoint are:

200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error
503 Service Unavailable