> ## Documentation Index > Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Retailers > The public catalog of retailers Zinc supports — no authentication required. `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. ```json 200 OK theme={null} { "retailers": [ { "retailer": "amazon", "display_name": "Amazon", "supported": true, "base_url": "amazon.com", "supported_countries": ["US", "DE", "UK"], "free_shipping": true, "free_shipping_threshold_cents": 2500 }, { "retailer": "walmart", "display_name": "Walmart", "supported": true, "base_url": "walmart.com", "supported_countries": ["US"], "free_shipping": true, "free_shipping_threshold_cents": 3500 } ], "total": 2 } ``` ## OpenAPI ````yaml versions/latest.json GET /retailers openapi: 3.1.0 info: title: Zinc summary: >- Zinc lets you search, buy, and return items from top online retailers with a single API. description: >- Search, buy, and return items from top online retailers with a single API. Supports AI agent ordering via MPP (HTTP 402) — no account required. Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon DE, Best Buy, Lowe's, Partstown, Pokémon Center, Target, The Home Depot, Walmart, Wayfair, and 2 more. Ships to the US and 1 other country (DE). version: '2026-07-10' x-logo: url: https://mintlify.s3.us-west-1.amazonaws.com/zinc/logo/light.png contact: name: Zinc API Support email: support@zinc.com url: https://zinc.com/docs x-guidance: >- Zinc lets AI agents buy products from online retailers via a single API. Use POST /agent/orders to place an order — no Zinc account needed, payment is handled via MPP (HTTP 402 flow). Provide a product URL from a supported retailer, a shipping address, and max_price in cents. The API charges max_price + $1 API fee upfront and refunds the difference on completion. To find products first, the /agent/* data endpoints (search, products/search, products/offers, products/details) are MPP-paid at $0.01 per call; /agent/search returns orderable URLs to feed straight into /agent/orders. GET /retailers lists supported retailers for free (no payment or account). Authenticated equivalents (orders, products, managed-accounts) require a Bearer token (API key prefixed zn_). Docs: https://zinc.com/docs Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon DE, Best Buy, Lowe's, Partstown, Pokémon Center, Target, The Home Depot, Walmart, Wayfair, and 2 more, shipping to the US and 1 other country (DE). x-supported-retailers: - 1-800-Flowers - Ace Hardware - Amazon - Amazon DE - Best Buy - Lowe's - Partstown - Pokémon Center - Target - The Home Depot - Walmart - Wayfair - Zinc - eBay x-supported-countries: - US - DE servers: - url: https://api.zinc.com description: Production security: - BearerAuth: [] paths: /retailers: get: tags: - retailers summary: List Retailers description: >- List the retailers Zinc supports — the public "what do you support?" catalog. No authentication required. One flat object per retailer brand: identifier, domain, countries shipped to, and the free-shipping policy. International marketplaces (e.g. amazon.com / amazon.de) are grouped under one brand with the country listed in `supported_countries`. Optionally filter by name. operationId: list_retailers_retailers_get parameters: - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: Number of retailers to return default: 100 title: Limit description: Number of retailers to return - name: offset in: query required: false schema: type: integer minimum: 0 description: Number of retailers to skip default: 0 title: Offset description: Number of retailers to skip - name: name in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by name (case-insensitive partial match) title: Name description: Filter by name (case-insensitive partial match) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicRetailerListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: [] components: schemas: PublicRetailerListResponse: properties: retailers: items: $ref: '#/components/schemas/PublicRetailer' type: array title: Retailers total: type: integer title: Total type: object required: - retailers - total title: PublicRetailerListResponse description: Public supported-retailer catalog. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PublicRetailer: properties: retailer: type: string title: Retailer description: Stable retailer identifier / slug, e.g. 'amazon'. display_name: anyOf: - type: string - type: 'null' title: Display Name description: Human-friendly name, e.g. 'Amazon'. base_url: anyOf: - type: string - type: 'null' title: Base Url description: Retailer domain, e.g. 'amazon.com'. no_account_needed: type: boolean title: No Account Needed description: >- Whether Zinc can place the order for you without your own account (guest checkout or Zinc-managed credentials). default: false use_your_account: type: boolean title: Use Your Account description: Whether you can order through your own retailer account. default: false supported_countries: items: type: string type: array title: Supported Countries description: ISO 3166-1 alpha-2 countries we ship to (defaults to ['US']). free_shipping: type: boolean title: Free Shipping description: >- Whether free shipping is offered (unconditionally or above free_shipping_threshold_cents). default: false free_shipping_threshold_cents: anyOf: - type: integer - type: 'null' title: Free Shipping Threshold Cents description: >- Order subtotal (cents) at/above which shipping is free; null means no threshold. type: object required: - retailer title: PublicRetailer description: >- A supported retailer in the public catalog — one flat object per brand. This is the customer-facing "what do you support?" shape: a retailer identifier, where to buy from, the countries we ship to, the free-shipping policy, and how orders are fulfilled (Zinc-managed vs. bring-your-own account). Internal guest-checkout/credential details remain omitted. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: apiKey in: header name: Authorization description: Zinc API key (Bearer zn_...) ````