Skip to content

Catalogs API

List an item's variants

GEThttps://email.growthdept.ai/api/catalog-items/{id}/variants

Sort by created, ascending or descending (put - in front).

Rate limits

Burst: 350/s

Steady: 3500/m

Tier XL. See rate limits for how requests are counted.

Scopes

catalogs:read

Operation id

get_variants_for_catalog_item The same operation as in Klaviyo's API. OpenAPI document

Path parameters

stringrequired

Query parameters

array of strings

Attributes of catalog-variant resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

string

Filter expression.

Filtering guide

Fields and the operators each one takes:

  • ids: any
  • item.id: equals
  • sku: equals
  • title: contains
  • published: equals

string

From links.next or links.prev of the previous page.

Pagination guide

integer1 to 100default 100

Default 100, at most 100.

Pagination guide

string

Default created.

Sorting guide

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataarray of objectsrequired

    data: 5 fields
    • typestringrequired

      catalog-variant
    • idstringrequired

    • attributesobjectrequired

      attributes: 15 fields
      • external_idstringcan be null

      • titlestringcan be null

      • descriptionstringcan be null

      • skustringcan be null

      • inventory_policyintegercan be null

        012
      • inventory_quantitynumbercan be null

      • pricenumbercan be null

      • urlstringcan be null

      • image_full_urlstringcan be null

      • image_thumbnail_urlstringcan be null

      • imagesarray of stringscan be null

      • custom_metadataobjectcan be null

      • publishedbooleancan be null

      • createdstring (date-time)can be null

      • updatedstring (date-time)can be null

    • relationshipsobject

      relationships: 1 field
      • itemobject

        item: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            catalog-item
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • linksobject

    links: 3 fields
    • selfstring (uri)required

    • prevstring (uri)

    • nextstring (uri)

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject