GET /api/catalog-items/{id}/relationships/variants

Get all variants related to the given item ID.

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

Returns a maximum of 100 variants per request.

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

Scopes: catalogs:read

Servers

Path parameters

Name Type Required Description
id String Yes

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.

Request headers

Name Type Required Description
revision String Yes

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

Default value: "2025-04-15"

Query parameters

Name Type Required Description
filter String No

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
sku: equals
title: contains
published: equals

sort String No

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

Possible values:

  • "created"
  • "-created"
pagecursor String No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.