Skip to main content
POST
Scope: nft:orders One box for 1-25 tokens: we re-quote the chosen rate for all the tokens together and open one payment for the shipping. Once paid, Get a shipment returns a burn per token; the box ships once every token is burned. The whole flow: Shipping.
Always send an Idempotency-Key, and reuse it when retrying. See Idempotency.
string
required
Your own shipment id: 8-128 characters of A-Za-z0-9_-. Shared key space with Create a one-token shipment.
string[]
required
1-25 distinct decimal token ids of your program, all held by holder. Send them as strings.
string
required
The wallet that holds every token now. Checked on chain. Every burn must come from it.
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. If the rate now costs more, nothing is created and you get PRICE_CHANGED with the current amount.
number | null
Shipping insurance cover in dollars, as for the estimate.

Response

201 (200 with "idempotent_replay": true on a replay).
object
object | null
Pay it exactly like an order (Payments). A replay with the same key returns payment again while the shipment is unpaid (null once paid). An unpaid shipment never expires: it stays awaiting_payment and can be paid at any time.
boolean
Present and true on a replay.

Errors

A refusal about particular tokens lists them in token_ids.