The item master (assortment) for the tenant, optionally by partner.

Item-master records

GET /v1/catalog

cURL

curl --silent --show-error --fail-with-body --request GET \
  --url 'https://api.edi.stateset.com/v1/catalog' \
  --header "Authorization: Bearer $EDI_API_TOKEN"

200

[
  {
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "history": [
      {
        "at": "2026-08-31T14:22:05Z",
        "changed_fields": [
          "string"
        ],
        "version": 1
      }
    ],
    "ids": [
      {
        "qualifier": "string",
        "value": "49.00"
      }
    ],
    "pack_size": "string",
    "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "prices": [
      {
        "price": "49.00",
        "qualifier": "string"
      }
    ],
    "sku": "SKU-TENT-2P-GRN",
    "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "updated_at": "2026-08-31T14:22:05Z",
    "version": 1
  }
]

Query parameters

partner_id · string

Filter to one partner

Response

CatalogItemRecord[] — each element:

description · string,null

history · CatalogChange[]

Append-only changelog of which attributes changed at each version bump.

Show CatalogChange

at · string (date-time) · required

changed_fields · string[] · required

Which attributes changed (description, prices, pack_size, ids).

version · integer (int32) · required

Minimum: 0.

ids · ProductId[]

Show ProductId

qualifier · string · required

value · string · required

pack_size · string,null

partner_id · string · required

prices · CatalogPrice[]

Show CatalogPrice

price · string · required

CTP-03 unit price.

qualifier · string · required

CTP-02 price-qualifier code (e.g. RES resale, UCP unit cost, LIS list). Defaults to an empty qualifier when the segment omits it.

sku · string · required

tenant_id · string · required

updated_at · string (date-time) · required

version · integer (int32) · required

Bumped each time the attributes change; 1 on first ingest. Minimum: 0.

Status codes

Code	Meaning
200	Item-master records
403	Admin credential required

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.

cURL

curl --silent --show-error --fail-with-body --request GET \
  --url 'https://api.edi.stateset.com/v1/catalog' \
  --header "Authorization: Bearer $EDI_API_TOKEN"

200

[
  {
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "history": [
      {
        "at": "2026-08-31T14:22:05Z",
        "changed_fields": [
          "string"
        ],
        "version": 1
      }
    ],
    "ids": [
      {
        "qualifier": "string",
        "value": "49.00"
      }
    ],
    "pack_size": "string",
    "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "prices": [
      {
        "price": "49.00",
        "qualifier": "string"
      }
    ],
    "sku": "SKU-TENT-2P-GRN",
    "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "updated_at": "2026-08-31T14:22:05Z",
    "version": 1
  }
]