List Orders
Orders
List Orders
Retrieve all orders for your account
GET
List Orders
Retrieve a list of all orders associated with your account. Orders are returned in reverse chronological order (most recent first).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.
Response
Returns an array of order objects, each containing:- id - Order UUID
- status - Current order status
- items - Products in the order
- shipping_address - Delivery address
- job_result - Processing results (for completed/failed orders)
- created_at - Order creation timestamp
- updated_at - Last update timestamp
Order Statuses
| Status | Description |
|---|---|
pending | Order queued, not yet processing |
in_progress | Order is being placed |
ordered | Successfully placed with retailer |
shipped | Order shipped (tracking available) |
delivered | Order delivered to address |
cancelled | Order was cancelled |
failed | Order processing failed |
Pagination
Currently, all orders are returned in a single response. Pagination will be added in a future update.
Authorizations
Zinc API key (Bearer zn_...)
Headers
Query Parameters
Number of orders to return
Required range:
1 <= x <= 500Number of orders to skip
Required range:
x >= 0Filter by order ID (partial match)
Filter by order status
Filter by return-request status. open → orders with at least one open return. closed → orders with at least one approved or denied return. Omit for no filter.

