Get brand categories

To customize the reward experience for different audience or use cases, 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.

Endpoint

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

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

Examples

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": [
    {}
  ]
}

Response codes

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:

Response code	Meaning
200	The request was successful.
400	The server could not understand the request due to invalid syntax.
401	Authentication is required and has either not been provided or failed.
403	The server understood the request but refuses to authorize it.
404	The server could not find the requested resource. In other words, the URL you’re trying to access doesn’t point to anything that exists on the server.
500	Something went wrong on the server, but the server cannot be more specific about what the exact problem is.
503	The server is currently unable to handle the request due to temporary overload or maintenance.