> ## 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](/docs/v2/api-reference/orders/list-orders) — 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.
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](/docs/v2/api-reference/orders/get-order#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. |
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 DE,
Barnes & Noble, Best Buy, Chewy, Gap, IBS, Lowe's, Macys, Partstown, and 12
more. Ships to the US and 2 other countries (DE, IT).
version: '2026-08-21'
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. Docs: https://zinc.com/docs
Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon DE,
Barnes & Noble, Best Buy, Chewy, Gap, IBS, Lowe's, Macys, Partstown, and 12
more, shipping to the US and 2 other countries (DE, IT).
x-supported-retailers:
- 1-800-Flowers
- Ace Hardware
- Amazon
- Amazon DE
- Barnes & Noble
- Best Buy
- Chewy
- Gap
- IBS
- Lowe's
- Macys
- Partstown
- Pokémon Center
- Sephora
- Target
- The Home Depot
- TikTok
- Uniqlo
- Walmart
- Wayfair
- Zinc
- eBay
- libraccio
- zazzle
x-supported-countries:
- US
- DE
- IT
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: 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: 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_...)
````