Get Item IDs for Catalog Category

get

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

Get all items in the given category ID. Returns a maximum of 100 items per request.

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

Scopes:
catalogs:read

Path Params

string | null

required

The catalog category 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

filter

string

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
ids: any
category.id: equals
title: contains
published: equals

page[cursor]

string

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

sort

string

enum

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

Allowed:

Headers

revision

string

required

Defaults to 2026-01-15

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

Responses

200Success

4XXClient Error

5XXServer Error