> ## Documentation Index
> Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mark a shipment shipped or delivered

> Sandbox only: play our shipping team, so you can build and test your tracking screens.

Scope: `nft:orders` · **Sandbox only:** `404` outside the [sandbox](https://catchbackcards.mintlify.site/partner-api/v2/quickstart.md)

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](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/get-shipment.md). It also delivers any webhooks the change produced.

**id** `string` *required*

A `shipment_id` or a `quote_id`.

**status** `string` *required*

`shipped` or `delivered`.

## Response

**ok** `boolean`

`true`.

**status** `string`

The status you set.

**webhooks** `object`

The webhook deliveries this call made.

## 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](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/sandbox-tick.md) |

```bash cURL theme={null}
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" }'
```

```json 200 theme={null}
{ "ok": true, "status": "shipped", "webhooks": { "delivered": 1, "retrying": 0 } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.