Skip to main content
GET
List Retailers
GET /retailers is the public catalog of curated retailer brands. It returns one flat object per brand with its identifier, domain, the countries Zinc ships to, and the free-shipping policy. No authentication required — no API key, no MPP payment.
This list is the curated set, not the limit of what Zinc can buy from. The order path accepts most stores, including ones Zinc has never seen. A store missing from this response is not unsupported.To ask about one specific URL, call GET /retailers/check. The coverage object on this response says the same thing in-band: coverage.policy is open, and coverage.platforms lists the storefront platforms (e.g. shopify) Zinc will attempt checkout on sight unseen.

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). An empty array means the retailer has declared no country restriction — not that it ships nowhere.
  • free_shipping indicates whether free shipping is offered either unconditionally or above free_shipping_threshold_cents. A null threshold means there is no minimum.
  • no_account_needed is true when Zinc can check out without a customer account at any of the brand’s storefronts — the store takes guests, or Zinc holds a shared account for it. use_your_account is true when the customer may supply their own retailer login. Both aggregate across the brand’s marketplaces: the brand offers a mode if any one storefront does.
  • Use limit / offset to page through results (default limit 100, max 1000), and name to filter by a case-insensitive partial match.
  • Pass include=all to get the long tail Zinc has ordered from but has not curated (hundreds of brands). Omit it for the curated set. all is the only accepted value; anything else is rejected. This selects how much of the catalog to return — it is not a filter on an entry’s support tier.

Support tiers

Each entry carries a support tier describing how well Zinc covers that brand: A listed entry is never unsupported — a storefront Zinc refuses is not listed at all. Every brand here is orderable, and so are most stores that are not listed.

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)

include
string | null

Pass all to include the long tail Zinc has ordered from but not curated (hundreds of brands). Omit for the curated set. This selects how much of the catalog to return; it is not a filter on an entry's support tier.

Response

Successful Response

Public supported-retailer catalog.

retailers
PublicRetailer · object[]
required
total
integer
required
coverage
CoverageInfo · object | null

States that the list is the curated set, not the limit of what Zinc can buy from. Additive; existing fields are unchanged.