curl -X POST "$CATCHBACK_BASE_URL/api/partner/v2/sandbox/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73" \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "shipped" }'
{ "ok": true, "status": "shipped", "webhooks": { "delivered": 1, "retrying": 0 } }
Sandbox
Mark a shipment shipped or delivered
Sandbox only: play our shipping team, so you can build and test your tracking screens.
POST
/
api
/
partner
/
v2
/
sandbox
/
shipments
/
{id}
curl -X POST "$CATCHBACK_BASE_URL/api/partner/v2/sandbox/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73" \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "shipped" }'
{ "ok": true, "status": "shipped", "webhooks": { "delivered": 1, "retrying": 0 } }
Scope:
nft:orders · Sandbox only: 404 outside the sandbox
Plays our shipping team. { "status": "shipped" } marks a burned shipment shipped, with a test USPS tracking number, a tracking link, shipped_at and an expected_delivery three days out. { "status": "delivered" } then sets delivered_at. Read the result with Get a shipment. It also delivers any webhooks the change produced.
Response
Errors
| Status | Code | When |
|---|---|---|
400 | status isn’t shipped or delivered | |
404 | UNKNOWN_SHIPMENT | No such shipment in your program |
404 | Not the sandbox | |
409 | NOT_BURNED | The shipment has no shipping order yet: burn every token, then tick |
curl -X POST "$CATCHBACK_BASE_URL/api/partner/v2/sandbox/shipments/7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73" \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "shipped" }'
{ "ok": true, "status": "shipped", "webhooks": { "delivered": 1, "retrying": 0 } }

