> ## 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.

# Create a one-token shipment

> Create and pay for a shipment of one token, with the token in the path.

Scope: `nft:orders`

The same as [Create a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-shipment.md), 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](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/get-shipment.md) with the `quote_id` returns what the holder burns with; the burn ships the item.

> [!WARNING]
>
> Always send an `Idempotency-Key`, and reuse it when retrying. See [Idempotency](https://catchbackcards.mintlify.site/partner-api/v2/idempotency.md).

**tokenId** `string` *required*

The token's decimal `token_id`.

**Idempotency-Key** `string` *required*

8-128 characters of `A-Za-z0-9_-`. Shared key space with [Create a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-shipment.md).

**holder** `string` *required*

The wallet that holds the token now. Checked on chain.

**address** `object` *required*

As for [Estimate a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/estimate-shipment.md).

**rate** `object` *required*

`{ "carrier": "...", "token": "..." }` from an estimate's `rates`.

**max\_cost** `number` *required*

The most the holder will pay for shipping, in dollars: pass the estimate's `total`.

**cover\_amount** `number | null`

Shipping insurance cover in dollars.

## Response

**201** (200 with `"idempotent_replay": true` on a replay).

**quote** `object`

The shipment: `quote_id`, `status`, `shipping_cost`, `holder`, `expires_at`, `paid_at` and `burn` (null until paid).

**payment** `object | null`

As for [Create a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-shipment.md): `null` once paid.

**idempotent\_replay** `boolean`

Present and `true` on a replay.

## Errors

The same as [Create a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-shipment.md), except `BAD_TOKEN_IDS`, which doesn't apply. `TOKEN_IN_SHIPMENT` carries that shipment's `quote_id`.

```bash cURL theme={null}
curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/shipment \
  -H "Authorization: Bearer $CATCHBACK_KEY" \
  -H "Idempotency-Key: okx-ship-7a20b1" \
  -H "Content-Type: application/json" \
  -d '{
    "holder": "0x8f3c...e21a",
    "address": { "name": "Alice Tester", "address1": "1 Market St", "city": "San Francisco", "state": "CA", "zip": "94105", "country": "US", "phone": "4155550100" },
    "rate": { "carrier": "USPS", "token": "usps_priority" },
    "max_cost": 9.85
  }'
```

```json 201 theme={null}
{
  "quote": {
    "quote_id": "0xa93f...0c2d",
    "status": "awaiting_payment",
    "shipping_cost": 9.85,
    "holder": "0x8f3c...e21a",
    "expires_at": "2026-11-17T18:40:00.000Z",
    "paid_at": null,
    "burn": null
  },
  "payment": { "intent_id": "pi_01JE...", "client_secret": "...", "publishable_key": "pk_live_...", "amount": 9.85, "deposit_addresses": ["..."] }
}
```


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