Skip to main content
GET
List orders

Authorizations

Authorization
string
header
required

Your API key (cb_live_…), sent as a bearer token, with the scope nft:orders. Keep it on your servers: never in a browser, app or wallet. Use a separate key per environment. A request from a country on our sanctions list gets a 403 with Access denied, whether or not it has a valid key. See Authentication and keys.

Scopes

nft:orders

Query Parameters

wallet
string

A recipient address on your mint chain.

partner_user_ref
string

A partner_user_ref you sent with an order.

Pattern: ^[A-Za-z0-9_.:-]{1,128}$
status
enum<string>

Only orders in this status.

Available options:
awaiting_payment,
paid,
rolled,
minted,
mint_failed,
expired,
refund_due,
refunded
limit
integer
default:25

Page size, 1-100.

Required range: 1 <= x <= 100
cursor
string

The next_cursor of the previous page, unchanged. Omit for the first page.

Maximum string length: 400

Response

One page of orders.

orders
object[]
required

One pack of a multi-pack order, in the single-order shape under the order's order_id.

next_cursor
string | null
required

Pass it back unchanged as cursor for the next page. Opaque. Null on the last page.