Skip to main content
POST
Scope: nft:orders The same as Create a shipment, for one token: it takes the same body without token_ids and answers with the shipment as quote (no shipment_id, no tokens: the token’s own quote_id names the shipment). Once paid, Get a shipment with the quote_id returns what the holder burns with; the burn ships the item.
Always send an Idempotency-Key, and reuse it when retrying. See Idempotency.
string
required
The token’s decimal token_id.
string
required
8-128 characters of A-Za-z0-9_-. Shared key space with Create a shipment.
string
required
The wallet that holds the token now. Checked on chain.
object
required
object
required
{ "carrier": "...", "token": "..." } from an estimate’s rates.
number
required
The most the holder will pay for shipping, in dollars: pass the estimate’s total.
number | null
Shipping insurance cover in dollars.

Response

201 (200 with "idempotent_replay": true on a replay).
object
The shipment: quote_id, status, shipping_cost, holder, expires_at, paid_at and burn (null until paid).
object | null
As for Create a shipment: null once paid.
boolean
Present and true on a replay.

Errors

The same as Create a shipment, except BAD_TOKEN_IDS, which doesn’t apply. TOKEN_IN_SHIPMENT carries that shipment’s quote_id.