Skip to main content
GET
List shipments

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

The holder, on your mint chain.

status
enum<string>

Only shipments in this status.

Available options:
awaiting_payment,
ready,
redeemed,
expired,
partially_redeemed
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 shipments.

shipments
object[]
required

A multi-token shipment (shipment_id, tokens) or a one-token shipment (quote_id, burn).

next_cursor
string | null
required

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