Get Categories for Catalog Item

get https://a.klaviyo.com/api/catalog-items/{id}/categories

Get all catalog categories that an item with the given item ID is in.

Catalog categories can be sorted by the following fields, in ascending and descending order:
created

Returns a maximum of 100 categories per request.

Rate limits:
Burst: 350/s
Steady: 3500/m

Scopes:
catalogs:read

Path Params

string | null

required

The catalog item ID is a compound ID (string), with format: {integration}:::{catalog}:::{external_id}. Currently, the only supported integration type is $custom, and the only supported catalog is $default.

Query Params

fields[catalog-category]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[catalog-category]

filter

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
ids: any
item.id: equals
name: contains

page[cursor]

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#pagination

sort

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sorting

Headers

revision

string

required

Defaults to 2025-04-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://a.klaviyo.com/api/catalog-items/id/categories \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'revision: 2025-04-15'


xxxxxxxxxx
31
}
1
{
2
  "data": [
3
    {
4
      "type": "catalog-category",
5
      "id": "$custom:::$default:::SAMPLE-DATA-CATEGORY-APPAREL",
6
      "attributes": {
7
        "external_id": "SAMPLE-DATA-CATEGORY-APPAREL",
8
        "name": "Sample Data Category Apparel",
9
        "updated": "2022-11-08T00:00:00+00:00"
10
      },
11
      "links": {
12
        "self": "string"
13
      },
14
      "relationships": {
15
        "items": {
16
          "links": {
17
            "self": "string",
18
            "related": "string"
19
          }
20
        }
21
      }
22
    }
23
  ],
24
  "links": {
25
    "self": "string",

200Success

4XXClient Error

5XXServer Error