curl https://catchbackcards.com/api/partner/v2/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73 \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "redeemed",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "90311820476190023716442901288201455", "quote_id": "0x1b7c...e4a0", "status": "redeemed", "burned_at": "2026-11-16T19:02:10.000Z", "burn_tx": "0x51c0...", "burn": null },
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "redeemed", "burned_at": "2026-11-16T19:04:55.000Z", "burn_tx": "0x3be1...", "burn": null }
],
"fulfilment": {
"status": "shipped",
"carrier": "USPS",
"service": "Priority Mail",
"tracking_number": "9400111899223456789012",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
"shipped_at": "2026-11-17T16:02:11.000Z",
"expected_delivery": "2026-11-20",
"delivered_at": null,
"created_at": "2026-11-16T19:05:30.000Z"
}
}
}
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "ready",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "ready", "burned_at": null, "burn_tx": null, "burn": { "quote": { "tokenId": "...", "kind": 2, "...": "..." }, "signature": "0x..." } }
],
"fulfilment": null
}
}
Shipments
Get a shipment
One shipment: the burn details once paid, then carrier tracking.
GET
/
api
/
partner
/
v2
/
shipments
/
{id}
curl https://catchbackcards.com/api/partner/v2/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73 \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "redeemed",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "90311820476190023716442901288201455", "quote_id": "0x1b7c...e4a0", "status": "redeemed", "burned_at": "2026-11-16T19:02:10.000Z", "burn_tx": "0x51c0...", "burn": null },
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "redeemed", "burned_at": "2026-11-16T19:04:55.000Z", "burn_tx": "0x3be1...", "burn": null }
],
"fulfilment": {
"status": "shipped",
"carrier": "USPS",
"service": "Priority Mail",
"tracking_number": "9400111899223456789012",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
"shipped_at": "2026-11-17T16:02:11.000Z",
"expected_delivery": "2026-11-20",
"delivered_at": null,
"created_at": "2026-11-16T19:05:30.000Z"
}
}
}
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "ready",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "ready", "burned_at": null, "burn_tx": null, "burn": { "quote": { "tokenId": "...", "kind": 2, "...": "..." }, "signature": "0x..." } }
],
"fulfilment": null
}
}
Scope:
nft:orders
Once the shipping payment settles, status becomes ready and each token’s burn holds what the holder burns it with. After every burn is seen, fulfilment carries the delivery. Statuses: Shipping.
This response never includes the payment object: replay the create POST to get it. We never return the delivery address or the shipping label.
A
shipment_id, or any quote_id (a token in a multi-token shipment returns its whole shipment).Response
Show shipment
Show shipment
Multi-token shipments only:
token_id, quote_id, status (awaiting_payment, ready, expired, redeemed or dropped), burned_at, burn_tx and burn.What the holder burns with, while the token is
ready. EVM: { "quote": { ...the Quote tuple, "kind": 2, "amount": "0" }, "signature": "0x..." }: call burnWithQuote exactly as for a sell-back. Solana: { "transaction": "<base64>", "vault": "...", "last_valid_block_height": ... }: each GET builds a fresh transaction, so fetch it right before signing.Errors
| Status | Code | When |
|---|---|---|
404 | UNKNOWN_SHIPMENT | No such shipment in your program |
curl https://catchbackcards.com/api/partner/v2/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73 \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "redeemed",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "90311820476190023716442901288201455", "quote_id": "0x1b7c...e4a0", "status": "redeemed", "burned_at": "2026-11-16T19:02:10.000Z", "burn_tx": "0x51c0...", "burn": null },
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "redeemed", "burned_at": "2026-11-16T19:04:55.000Z", "burn_tx": "0x3be1...", "burn": null }
],
"fulfilment": {
"status": "shipped",
"carrier": "USPS",
"service": "Priority Mail",
"tracking_number": "9400111899223456789012",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
"shipped_at": "2026-11-17T16:02:11.000Z",
"expected_delivery": "2026-11-20",
"delivered_at": null,
"created_at": "2026-11-16T19:05:30.000Z"
}
}
}
{
"shipment": {
"shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73",
"status": "ready",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"tokens": [
{ "token_id": "81264573985362058461377125337283195667", "quote_id": "0xa93f...0c2d", "status": "ready", "burned_at": null, "burn_tx": null, "burn": { "quote": { "tokenId": "...", "kind": 2, "...": "..." }, "signature": "0x..." } }
],
"fulfilment": null
}
}

