> ## 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. # Export Orders > Download your orders as a CSV, using the same filters as the list endpoint. Stream the orders you can see as a CSV file. This is the download behind the dashboard's Orders table, and it takes the same filters as [List Orders](https://www.zinc.com/docs/v2/api-reference/orders/list-orders.md) — so an export contains exactly the rows you were looking at. The response is `text/csv` with `Content-Disposition: attachment; filename="zinc-orders.csv"`, not JSON. > [!NOTE] > > There is no `limit`/`offset`. The export always covers the whole filtered set, > paged internally, so a large account gets every matching order in one file. ## Columns | Column | Meaning | | - | - | | `order_id` | Order UUID. | | `created_at` | Order creation timestamp. | | `status` | Current order status. | | `retailer` | Retailer the order was placed with. | | `item_count` | Number of products on the order. | | `product_urls` | Product URLs, space-separated. | | `max_price_cents` | The order's `max_price`, in cents. | | `total_cents` | Amount actually charged by the retailer, in cents. | | `tracking_numbers` / `carriers` | Tracking numbers and their carriers. | | `estimated_delivery` | Latest carrier estimate, when known. | | `return_status` | `open` or `closed` when a return exists. | | `error_type` / `error` | Failure code and message for failed orders. | | `merchant_order_ids` | The retailer's own order number(s) — see [Merchant Order IDs](https://www.zinc.com/docs/v2/api-reference/orders/get-order.md#merchant-order-ids). | | `po_number` | The order's purchase-order number, when set. | | `created_by` | Email of the teammate who placed the order; empty on single-user accounts. | > [!NOTE] > > To export just one teammate's orders, filter with `user_email` — a > case-insensitive substring match on the address in `created_by`. See > [Filtering by teammate](https://www.zinc.com/docs/v2/api-reference/orders/list-orders.md#filtering-by-teammate). > [!NOTE] > > Under a `zn_test_` key (or `X-Test-Mode`) this exports the sandbox orders. ## OpenAPI ````yaml versions/latest.json GET /orders/export 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 CA, Amazon DE, Amazon FR, Amazon MX, Amazon UK, Barnes & Noble, Best Buy, Chewy, Gap, and 18 more. Ships to the US and 6 other countries (CA, DE, FR, GB, IT, MX). The listed retailers are the ones Zinc verifies with daily test orders, not the limit of what Zinc can buy from: checkout is attempted at most online stores, including Shopify-hosted ones. To ask about a specific store before ordering, call GET /retailers/check?url=... — it answers whether Zinc will attempt that URL. version: '2026-10-16' 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_); those orders are paid from a prefunded wallet — GET /wallet/me returns the spendable balance and per-order fee, so check it before POST /orders to avoid a 402. Orders are strict by default: if the gift option can't be applied or any item can't be bought, the whole order fails. When the user wants whatever can be shipped, send fulfillment: {"gift": "best_effort", "items": "best_effort"} and read fulfillment.concessions on the order to see what was relaxed. max_price is never relaxed. Docs: https://zinc.com/docs Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon CA, Amazon DE, Amazon FR, Amazon MX, Amazon UK, Barnes & Noble, Best Buy, Chewy, Gap, and 18 more, shipping to the US and 6 other countries (CA, DE, FR, GB, IT, MX). The listed retailers are the ones Zinc verifies with daily test orders, not the limit of what Zinc can buy from: checkout is attempted at most online stores, including Shopify-hosted ones. To ask about a specific store before ordering, call GET /retailers/check?url=... — it answers whether Zinc will attempt that URL. x-supported-retailers: - 1-800-Flowers - Ace Hardware - Amazon - Amazon CA - Amazon DE - Amazon FR - Amazon MX - Amazon UK - Barnes & Noble - Best Buy - Chewy - Gap - Grainger - IBS - Lowe's - Macys - McMaster-Carr - Partstown - Pokémon Center - Sephora - Target - The Home Depot - TikTok - Uniqlo - Walmart - Wayfair - Zinc - eBay - libraccio - zazzle x-supported-countries: - US - CA - DE - FR - GB - IT - MX servers: - url: https://api.zinc.com description: Production security: - BearerAuth: [] paths: /orders/export: get: tags: - orders summary: Export Orders Csv description: >- Stream the current user's orders as a CSV file. Takes the same filters as ``GET /orders`` (via the shared ``_visible_orders_filter``) so an export always contains exactly the rows the caller was looking at — but no ``limit``/``offset``: the export covers the whole filtered set, paged internally so memory stays flat. operationId: export_orders_csv_orders_export_get parameters: - name: order_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by order ID (partial match) title: Order Id description: Filter by order ID (partial match) - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Partial match on order ID OR tracking number title: Search description: Partial match on order ID OR tracking number - name: status_filter in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by order status title: Status Filter description: Filter by order status - name: merchant_order_id in: query required: false schema: anyOf: - type: string maxLength: 200 - type: 'null' description: Filter by the retailer's own order number (exact match) title: Merchant Order Id description: Filter by the retailer's own order number (exact match) - name: shipping_name in: query required: false schema: anyOf: - type: string maxLength: 200 - type: 'null' description: Shipping recipient's name (case-insensitive partial match) title: Shipping Name description: Shipping recipient's name (case-insensitive partial match) - name: tracking_status in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter to orders having at least one tracking number with this status title: Tracking Status description: >- Filter to orders having at least one tracking number with this status - name: has_tracking in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Only orders with (true) or without (false) tracking title: Has Tracking description: Only orders with (true) or without (false) tracking - name: return_status in: query required: false schema: anyOf: - type: string - type: 'null' description: '`open` or `closed` return requests; omit for no filter' title: Return Status description: '`open` or `closed` return requests; omit for no filter' - name: created_after in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Only orders created at/after this instant (inclusive) title: Created After description: Only orders created at/after this instant (inclusive) - name: created_before in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Only orders created before this instant (exclusive) title: Created Before description: Only orders created before this instant (exclusive) - name: metadata_key in: query required: false schema: anyOf: - type: string maxLength: 200 - type: 'null' description: Top-level `metadata` key to match; send with `metadata_value` title: Metadata Key description: Top-level `metadata` key to match; send with `metadata_value` - name: metadata_value in: query required: false schema: anyOf: - type: string maxLength: 500 - type: 'null' description: Exact value `metadata_key` must equal; send with `metadata_key` title: Metadata Value description: Exact value `metadata_key` must equal; send with `metadata_key` - name: user_email in: query required: false schema: anyOf: - type: string maxLength: 320 - type: 'null' description: >- Filter to orders placed by one org teammate, matched as a case-insensitive substring of their email. Only ever narrows within the caller's organization; a solo user can only match their own address. title: User Email description: >- Filter to orders placed by one org teammate, matched as a case-insensitive substring of their email. Only ever narrows within the caller's organization; a solo user can only match their own address. - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': description: CSV file of the filtered orders. content: text/csv: schema: type: string '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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_...) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.