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

# List shipments

> Your program's shipments, one-token and multi-token together, newest first, paged.

Scope: `nft:orders`

Newest first: one-token and multi-token shipments together, each in its [Get a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/get-shipment.md) shape.

**wallet** `string`

The `holder`, on your mint chain. Default: all.

**status** `string`

`awaiting_payment`, `ready`, `redeemed`, `expired` or `partially_redeemed`. Default: all.

**limit** `integer` (default: 25)

1-100.

**cursor** `string`

The `next_cursor` of the previous page.

## Response

**shipments** `object[]`

Each in its [Get a shipment](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/get-shipment.md) shape.

**next\_cursor** `string | null`

Null on the last page.

## Errors

| Status | Code | When |
| - | - | - |
| `400` | `BAD_CURSOR` | `cursor` isn't a `next_cursor` from a previous page |
| `400` | `BAD_LIMIT` | `limit` isn't 1-100 |
| `400` | `BAD_STATUS` | `status` isn't one the list filters on; the message lists them |
| `400` | `BAD_ADDRESS` | `wallet` is not an address on your mint chain |

```bash cURL theme={null}
curl "https://catchbackcards.com/api/partner/v2/shipments?wallet=0x8f3c...e21a&status=ready&limit=25" \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "shipments": [
    { "shipment_id": "7e2a91c4-5b0d-4f3e-8a6c-1d9b0e2f4a73", "status": "ready", "shipping_cost": 9.85, "...": "..." },
    { "quote_id": "0xa93f...0c2d", "status": "ready", "shipping_cost": 9.85, "...": "..." }
  ],
  "next_cursor": null
}
```


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