# Zinc Docs

- [Introduction](https://www.zinc.com/docs/v1/index.md): Zinc lets you search, buy, and return items from top online retailers with a single API.
- [What is Zinc?](https://www.zinc.com/docs/what-is-zinc.md): Zinc is building the universal API for ecommerce automation. With a single integration, you can buy products, retrieve pricing and product data, and automate order management across the world's top online retailers.
- [Quickstart](https://www.zinc.com/docs/v1/quickstart.md): Get started with Zinc API in minutes.
- [Supported Retailers](https://www.zinc.com/docs/v1/supported-retailers.md): See which retailers are supported by Zinc API.
- [Authentication](https://www.zinc.com/docs/v1/api-reference/introduction/authentication.md): How to authenticate with the Zinc API
- [Idempotency](https://www.zinc.com/docs/v1/api-reference/introduction/idempotency.md): Ensure safe retries and avoid duplicate operations with idempotency keys
- [Error Handling](https://www.zinc.com/docs/v1/api-reference/introduction/error-handling.md): Understand error responses and how to handle them
- [Webhooks](https://www.zinc.com/docs/v1/api-reference/introduction/webhooks.md): Receive real-time updates from the Zinc API using webhooks.
- [Accounts & Payments](https://www.zinc.com/docs/v1/api-reference/introduction/accounts-payments.md): How to pay for purchases with Zinc
- [Create Order](https://www.zinc.com/docs/v1/api-reference/orders/create.md): Create a new order via the Zinc API
- [Retrieve Order](https://www.zinc.com/docs/v1/api-reference/orders/retrieve.md): Get the status of an order from the order request_id
- [List Orders](https://www.zinc.com/docs/v1/api-reference/orders/list.md): Get a list of all orders in your account
- [Abort Order](https://www.zinc.com/docs/v1/api-reference/orders/abort.md): Abort an order in progress
- [Retry Order](https://www.zinc.com/docs/v1/api-reference/orders/retry.md): Retry a failed order
- [Create Cancellation](https://www.zinc.com/docs/v1/api-reference/cancellations/create.md): Initiate a cancellation for an order
- [Retrieve Cancellation](https://www.zinc.com/docs/v1/api-reference/cancellations/retrieve.md): Retrieve the status of a cancellation
- [Create Return](https://www.zinc.com/docs/v1/api-reference/returns/create.md): Start a return for an order
- [Retrieve Return](https://www.zinc.com/docs/v1/api-reference/returns/retrieve.md): Retrieve the status of a return
- [Create Case](https://www.zinc.com/docs/v1/api-reference/cases/create.md): Open a new case on your Zinc Managed Account (ZMA) order
- [Retrieve Case](https://www.zinc.com/docs/v1/api-reference/cases/retrieve.md): Get the status and history of a case
- [Update Case](https://www.zinc.com/docs/v1/api-reference/cases/update.md): Add a message to an existing case
- [Product Details](https://www.zinc.com/docs/v1/api-reference/products/details.md): Retrieve product details for a specific product
- [Product Offers](https://www.zinc.com/docs/v1/api-reference/products/offers.md): Retrieve product offers for a specific product
- [Product Search](https://www.zinc.com/docs/v1/api-reference/products/search.md): Endpoint to search for products.
- [Amazon Email Verification](https://www.zinc.com/docs/v1/api-reference/appendix/amazon-email-verification.md): How to handle Amazon email verification requirements during orders
- [Amazon Blank Offers](https://www.zinc.com/docs/v1/api-reference/appendix/amazon-blank-offers.md): Understanding and resolving Amazon's anti-bot blank offers page issue
- [Proxies](https://www.zinc.com/docs/v1/api-reference/appendix/proxies.md): Configure your own proxy service for better reliability and account protection
- [Frequently Asked Questions](https://www.zinc.com/docs/v1/api-reference/appendix/faq.md): Common questions and answers about the Zinc API
- [Product](https://www.zinc.com/docs/v1/object-reference/product.md): Product object structure and attributes
- [Seller Selection Criteria](https://www.zinc.com/docs/v1/object-reference/seller-selection-criteria.md): Seller selection criteria object structure and attributes
- [Shipping](https://www.zinc.com/docs/v1/object-reference/shipping.md): Shipping object structure and attributes
- [Address](https://www.zinc.com/docs/v1/object-reference/address.md): Address object structure and attributes
- [Payment Method](https://www.zinc.com/docs/v1/object-reference/payment-method.md): Payment method object structure and attributes
- [Webhooks](https://www.zinc.com/docs/v1/object-reference/webhooks.md): Webhooks object structure and attributes
- [Retailer Credentials](https://www.zinc.com/docs/v1/object-reference/retailer-credentials.md): Retailer credentials object structure and attributes
- [Promo Code](https://www.zinc.com/docs/v1/object-reference/promo-code.md): Promo code object structure and attributes
- [Price Components](https://www.zinc.com/docs/v1/object-reference/price-components.md): Price components object structure and attributes
- [Merchant Order IDs](https://www.zinc.com/docs/v1/object-reference/merchant-order-ids.md): Merchant order IDs object structure and attributes
- [Account Status](https://www.zinc.com/docs/v1/object-reference/account-status.md): Account status object structure and attributes
- [Product Offer](https://www.zinc.com/docs/v1/object-reference/product-offer.md): Product offer object structure and attributes
- [Tracking](https://www.zinc.com/docs/v1/object-reference/tracking.md): Tracking object structure and attributes
- [Introduction](https://www.zinc.com/docs/index.md): Zinc lets you search, buy, and return items from top online retailers with a single API.
- [Quickstart](https://www.zinc.com/docs/quickstart.md): Get started with Zinc API in minutes.
- [Zinc for Claude and ChatGPT](https://www.zinc.com/docs/v2/mcp/overview.md): Shop Amazon, Walmart, Target, Best Buy and more from a chat. Search, review the total, pay by card, and track the order — no Zinc account needed to buy.
- [Connect a Client](https://www.zinc.com/docs/v2/mcp/connect.md): Add the Zinc connector to Claude or ChatGPT. No account is needed to buy; sign in only when you want your order history.
- [Using the Zinc Connector](https://www.zinc.com/docs/v2/mcp/usage.md): Search products, review and pay for an order, and track it, all from a conversation in Claude or ChatGPT.
- [Agent Sandbox](https://www.zinc.com/docs/v2/agent-sandbox/overview.md): How an agent gets from nothing to a real order: a sandbox key with no signup, one browser approval from a human, then a live key with a starter credit in the wallet.
- [Agent Sandbox Quickstart](https://www.zinc.com/docs/v2/agent-sandbox/quickstart.md): Go from nothing to a delivered sandbox order in a few seconds — no account, no signup, no configuration.
- [Going Live](https://www.zinc.com/docs/v2/agent-sandbox/going-live.md): A human approves the agent in a browser, the agent collects its own live key and a starter credit, and places a real order.
- [Universal Checkout Skill](https://www.zinc.com/docs/v2/agent-skills/overview.md): Let AI agents discover, buy, track, and return products with the Zinc API.
- [Install the Skill](https://www.zinc.com/docs/v2/agent-skills/setup.md): Install and configure the Universal Checkout Skill so your AI agent can buy and track orders through the Zinc API.
- [Using the Skill](https://www.zinc.com/docs/v2/agent-skills/usage.md): Use the Universal Checkout Skill to discover products, place and track orders, and handle returns with your AI agent via the Zinc API.
- [Retailer Accounts](https://www.zinc.com/docs/v2/retailer-accounts.md): Who places your order at the retailer — Zinc's accounts by default, or your own.
- [Wallet](https://www.zinc.com/docs/v2/wallet.md): Prefund a Zinc Wallet balance and let Zinc draw each order's cost and fee automatically.
- [Stripe Connect](https://www.zinc.com/docs/v2/connect.md): Charge your own customer's card in real time and keep a margin, with no prepaid Zinc balance.
- [Machine Payments Protocol (MPP)](https://www.zinc.com/docs/v2/mpp.md): Enable AI agents to place orders and pay via HTTP 402 — no Zinc account required.
- [Migrating from V1](https://www.zinc.com/docs/v2/migrating-from-v1.md): Step-by-step guide to migrating your integration from the Zinc API v1 to v2.
- [V1 → V2 migration reference](https://www.zinc.com/docs/v2/migration-reference.md): Endpoint-by-endpoint mapping, request and response shape diffs, webhook consolidation, and validation steps for porting an existing Zinc v1 integration to Zinc API v2.
- [V1 → V2 migration: agent runbook](https://www.zinc.com/docs/v2/migration-agent-runbook.md): Workflow for Claude Code (or any coding agent) to execute the v1 → v2 port directly against your integration repository.
- [What is Zinc?](https://www.zinc.com/docs/what-is-zinc.md): Zinc is building the universal API for ecommerce automation. With a single integration, you can buy products, retrieve pricing and product data, and automate order management across the world's top online retailers.
- [Changelog](https://www.zinc.com/docs/changelog.md): Product updates and improvements to Zinc API
- [Authentication](https://www.zinc.com/docs/v2/api-reference/introduction/authentication.md): Authenticate Zinc API requests with your client token and API key.
- [Idempotency](https://www.zinc.com/docs/v2/api-reference/introduction/idempotency.md): Send idempotent Zinc API requests to safely retry orders without creating duplicates.
- [Sandbox & Testing](https://www.zinc.com/docs/v2/api-reference/introduction/sandbox.md): Test your Zinc API integration in the sandbox — place and simulate orders without buying anything.
- [Error Handling](https://www.zinc.com/docs/v2/api-reference/introduction/error-handling.md): Understand Zinc API error codes, status responses, and how to handle failures gracefully.
- [Webhooks](https://www.zinc.com/docs/v2/api-reference/introduction/webhooks.md): Receive real-time Zinc webhooks for order status, tracking, and delivery events.
- [API Changelog](https://www.zinc.com/docs/v2/api-reference/introduction/api-changelog.md): Release notes and version-by-version changes to the Zinc API v2.
- [Agent Sandbox](https://www.zinc.com/docs/v2/api-reference/sandbox/overview.md): The four /sandbox/* routes an agent uses to mint its own test key, onboard itself, and graduate into a real Zinc account.
- [Mint a Sandbox Key](https://www.zinc.com/docs/v2/api-reference/sandbox/mint-sandbox-key.md): Mint a sandbox API key with no account and no authentication, and get a complete example order back with it.
- [Agent Quickstart](https://www.zinc.com/docs/v2/api-reference/sandbox/get-agent-quickstart.md): Fetch the zero-to-delivered-order agent quickstart as plain markdown, served for agents to execute rather than read.
- [Claim a Sandbox](https://www.zinc.com/docs/v2/api-reference/sandbox/claim-sandbox.md): Fold a provisional sandbox — its order history and its API key — into a real Zinc account without breaking the agent that created it.
- [Get Sandbox Status](https://www.zinc.com/docs/v2/api-reference/sandbox/get-sandbox-status.md): Check whether the sandbox this key belongs to has been claimed into a real Zinc account yet.
- [Start a Device Code](https://www.zinc.com/docs/v2/api-reference/device/start-device-code.md): Mint a device code so the account owner can approve your agent from any device and hand it its own live API key.
- [Redeem a Device Code](https://www.zinc.com/docs/v2/api-reference/device/redeem-device-code.md): Poll with your device code until the owner approves, then receive the live API key exactly once.
- [Describe a Device Code](https://www.zinc.com/docs/v2/api-reference/device/describe-device-code.md): Read what the approval page shows for a user code: who is asking, from what runtime, and whether it is still pending.
- [Approve a Device Code](https://www.zinc.com/docs/v2/api-reference/device/approve-device-code.md): The account owner's approve-or-deny decision, made from a signed-in browser session.
- [Cross-Retailer Search](https://www.zinc.com/docs/v2/api-reference/search/cross-retailer.md): Search every retailer Zinc supports in a single API call to compare products and prices (beta).
- [Create Order](https://www.zinc.com/docs/v2/api-reference/orders/create-order.md): Place a purchase order on Amazon, Walmart, and other retailers via the Zinc API.
- [List Orders](https://www.zinc.com/docs/v2/api-reference/orders/list-orders.md): List and filter all orders placed through your Zinc account.
- [Get Order](https://www.zinc.com/docs/v2/api-reference/orders/get-order.md): Retrieve the status and details of a specific Zinc order by its ID.
- [Get Order Timeline](https://www.zinc.com/docs/v2/api-reference/orders/get-order-timeline.md): Retrieve the customer-facing lifecycle timeline of events for a Zinc order.
- [Cancel Order](https://www.zinc.com/docs/v2/api-reference/orders/cancel-order.md): Cancel an in-progress Zinc order before retailer fulfillment completes.
- [Order Tracking](https://www.zinc.com/docs/v2/api-reference/orders/tracking.md): Retrieve carrier tracking numbers and delivery status for your Zinc orders.
- [Get Public Tracking](https://www.zinc.com/docs/v2/api-reference/orders/get-public-tracking.md): Retrieve the public, unauthenticated tracking view for an order by its UUID.
- [Export Orders](https://www.zinc.com/docs/v2/api-reference/orders/export-orders.md): Download your orders as a CSV, using the same filters as the list endpoint.
- [The Products Array](https://www.zinc.com/docs/v2/api-reference/orders/multiple-products-quantities.md): Build the Zinc order products array — multiple items, quantities, variants, and condition.
- [Validate Bulk Upload](https://www.zinc.com/docs/v2/api-reference/orders/validate-bulk-upload.md): Validate a CSV bulk upload with the Zinc API before placing any real orders.
- [Create Bulk Upload](https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload.md): Place many orders at once by uploading a CSV batch to the Zinc API.
- [List Bulk Uploads](https://www.zinc.com/docs/v2/api-reference/orders/list-bulk-uploads.md): List all bulk upload batches placed through your Zinc account.
- [Get Bulk Upload](https://www.zinc.com/docs/v2/api-reference/orders/get-bulk-upload.md): Retrieve a Zinc bulk upload batch with per-order status and results.
- [Download Bulk Results](https://www.zinc.com/docs/v2/api-reference/orders/download-bulk-results.md): Download the per-order results of a Zinc bulk upload batch as a CSV file.
- [List Managed Accounts](https://www.zinc.com/docs/v2/api-reference/managed-accounts/list-managed-accounts.md): List all managed accounts and stored retailer credentials on your Zinc account.
- [Create Managed Account](https://www.zinc.com/docs/v2/api-reference/managed-accounts/create-managed-account.md): Add retailer account credentials (a managed account) for Zinc to place orders with via the API.
- [Update Managed Account](https://www.zinc.com/docs/v2/api-reference/managed-accounts/update-managed-account.md): Update the stored retailer credentials for an existing Zinc managed account.
- [Delete Managed Account](https://www.zinc.com/docs/v2/api-reference/managed-accounts/delete-managed-account.md): Delete a managed account and its stored retailer credentials from your Zinc account.
- [Retailer Credentials](https://www.zinc.com/docs/v2/api-reference/configuration/managed-accounts.md): Configure retailer account credentials (managed accounts) so Zinc can place and process orders on your behalf.
- [Create Return Request](https://www.zinc.com/docs/v2/api-reference/returns/create-return.md): Submit a return request for an existing Zinc order via the API.
- [List Return Requests](https://www.zinc.com/docs/v2/api-reference/returns/list-returns.md): List all return requests submitted through your Zinc account.
- [Get Return Request](https://www.zinc.com/docs/v2/api-reference/returns/get-return.md): Retrieve the status and details of a specific Zinc return request by ID.
- [Search Products](https://www.zinc.com/docs/v2/api-reference/products/search.md): Search retailer catalogs for products, prices, and offer data via the Zinc API.
- [Get Product Details](https://www.zinc.com/docs/v2/api-reference/products/get-product.md): Retrieve product details, images, and attributes from a retailer via the Zinc API.
- [Get Product Offers](https://www.zinc.com/docs/v2/api-reference/products/get-product-offers.md): Retrieve all seller offers and prices for a product from a retailer via the Zinc API.
- [List Retailers](https://www.zinc.com/docs/v2/api-reference/retailers/list-retailers.md): Browse the public catalog of curated retailers — no authentication required. The list is not the limit of what Zinc can buy from.
- [Check a Retailer](https://www.zinc.com/docs/v2/api-reference/retailers/check-retailer.md): Ask whether Zinc can buy from a given store URL and ship it to a country — no authentication required.
- [Create MPP Order](https://www.zinc.com/docs/v2/api-reference/agent/create-order.md): Place an order and pay per request via the Machine Payments Protocol (MPP) — no Zinc account required.
- [Agent Search](https://www.zinc.com/docs/v2/api-reference/agent/search.md): Search every supported retailer in one call for AI agents, paid per request via the Machine Payments Protocol (MPP).
- [Agent Product Search](https://www.zinc.com/docs/v2/api-reference/agent/product-search.md): Search a retailer's catalog for AI agents, paid per call via the Machine Payments Protocol (MPP).
- [Agent Product Offers](https://www.zinc.com/docs/v2/api-reference/agent/product-offers.md): Retrieve offers and pricing for a product, paid per call via the Machine Payments Protocol (MPP).
- [Agent Product Details](https://www.zinc.com/docs/v2/api-reference/agent/product-details.md): Retrieve full product details for a single product, paid per call via the Machine Payments Protocol (MPP).
- [Get Wallet](https://www.zinc.com/docs/v2/api-reference/wallet/get-wallet.md): Read your wallet balance and the per-order fee, so you can tell whether an order will clear before you place it.
- [Get Webhook Endpoint](https://www.zinc.com/docs/v2/api-reference/webhooks/get-webhook-endpoint.md): Read the URL Zinc delivers this account's webhooks to, and the secret that signs them.
- [Set Webhook Endpoint](https://www.zinc.com/docs/v2/api-reference/webhooks/set-webhook-endpoint.md): Register or replace the URL Zinc POSTs this account's order and return events to.
- [Clear Webhook Endpoint](https://www.zinc.com/docs/v2/api-reference/webhooks/clear-webhook-endpoint.md): Stop webhook delivery for this account by clearing the registered URL.
- [Get My Usage](https://www.zinc.com/docs/v2/api-reference/usage/get-my-usage.md): Retrieve your Zinc API usage and order volume over a trailing time window.

## OpenAPI Specs

- [v1](/docs/v1/api-reference/openapi/v1.json)
- [v2](/docs/v1/api-reference/openapi/v2.json)
- [2025-11-24](/docs/versions/2025-11-24.json)
- [2025-12-19](/docs/versions/2025-12-19.json)
- [2026-01-09](/docs/versions/2026-01-09.json)
- [2026-01-19](/docs/versions/2026-01-19.json)
- [2026-01-21](/docs/versions/2026-01-21.json)
- [2026-01-28](/docs/versions/2026-01-28.json)
- [2026-02-05](/docs/versions/2026-02-05.json)
- [2026-02-12](/docs/versions/2026-02-12.json)
- [2026-02-19](/docs/versions/2026-02-19.json)
- [2026-03-23](/docs/versions/2026-03-23.json)
- [2026-03-25](/docs/versions/2026-03-25.json)
- [2026-04-27](/docs/versions/2026-04-27.json)
- [2026-06-11](/docs/versions/2026-06-11.json)
- [2026-06-19](/docs/versions/2026-06-19.json)
- [2026-06-26](/docs/versions/2026-06-26.json)
- [2026-07-06](/docs/versions/2026-07-06.json)
- [2026-07-10](/docs/versions/2026-07-10.json)
- [2026-07-17](/docs/versions/2026-07-17.json)
- [2026-07-29](/docs/versions/2026-07-29.json)
- [2026-08-10](/docs/versions/2026-08-10.json)
- [2026-08-11](/docs/versions/2026-08-11.json)
- [2026-08-21](/docs/versions/2026-08-21.json)
- [2026-09-11](/docs/versions/2026-09-11.json)
- [2026-09-18](/docs/versions/2026-09-18.json)
- [2026-09-30](/docs/versions/2026-09-30.json)
- [latest](/docs/versions/latest.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.