Skip to main content
GET
List Retailers
GET /retailers is the public “what do you support?” catalog. It returns one flat object per retailer brand with its identifier, domain, the countries Zinc ships to, and the free-shipping policy. No authentication required — no API key, no MPP payment.

Notes

  • International marketplaces (e.g. amazon.com / amazon.de) are grouped under a single brand, with each country listed in supported_countries (ISO 3166-1 alpha-2; defaults to ["US"]).
  • free_shipping indicates whether free shipping is offered either unconditionally or above free_shipping_threshold_cents. A null threshold means there is no minimum.
  • Orders are Zinc-managed by default (no retailer account needed), so account and guest-checkout details are omitted from this catalog.
  • Use limit / offset to page through results (default limit 100, max 1000), and name to filter by a case-insensitive partial match.

Query Parameters

limit
integer
default:100

Number of retailers to return

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of retailers to skip

Required range: x >= 0
name
string | null

Filter by name (case-insensitive partial match)

Response

Successful Response

Public supported-retailer catalog.

retailers
PublicRetailer · object[]
required
total
integer
required