GET · Products & purchasing
List the account's orders
List the account's orders
/api/v1/orders
Description
Returns data[] of orders — each with its orderId, ocr, status, totals, paidAt, paymentUrl (unpaid only) and provisioning[] — plus hasMore / nextCursor. Defaults to open (unpaid) orders; status=paid lists the ones that went through under their new invoice id. For one order's full detail call get_order; to cancel an unpaid one, cancel_order.
Query parameters
| Name | Type | Description |
|---|---|---|
status
|
enum |
Which orders: open (unpaid proformas, the default), paid (orders that went through — real invoices with paidAt), or all. One of open, paid, all.
|
limit
|
integer | Page size for a collection. Range 1–100. |
cursor
|
integer |
Opaque pagination cursor. Pass back the previous response’s nextCursor; stop when it is null. Minimum 0.
|
Responses
A 200 response returns the shape shown in the rail.
Every non-2xx response is an RFC 7807 problem with a stable
code.
Commonly returned errors
The codes this operation reaches on its own path: the auth stack, its own validation and
ownership checks, and the transport. Not a closed set — a shared code from the
full registry can still surface. Each links to the code’s own page,
the same URL its type dereferences to.