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

# Get an order

> One order, or a multi-pack order with its units, by our id or your Idempotency-Key.

Scope: `nft:orders`

Returns `{ "order": { ... } }`. After a lost response, this is how you find out how an order ended.

**id** `string` *required*

The order's `id`, or the `Idempotency-Key` you sent. A multi-pack order's `id` or key returns the whole order with its `units`; one unit's `id` returns that unit.

## Response

**order** `object`

**order**

**order\_id** `string`

Your `Idempotency-Key`.

**id** `string`

Our id.

**status** `string`

See [Orders and statuses](https://catchbackcards.mintlify.site/partner-api/v2/orders.md#order-statuses). A multi-pack order adds `processing` and `completed`.

**pack\_type** `string`

**category** `string`

**odds** `string`

The odds the pack is opened at.

**price** `number`

In dollars. On a multi-pack order, the total; `unit_price` is one pack.

**recipient** `string`

**mint\_chain** `string`

**paid\_at** `string | null`

**pull** `object | null`

Set once the pack opens: `card_id`, `category`, `name`, `value` (the item's value when it was pulled; it anchors the [sell-back offer](https://catchbackcards.mintlify.site/partner-api/v2/sell-back.md)) and `pulled_at`.

**token** `object | null`

Set once the mint is reserved: `chain`, `contract` (on a Solana program, `collection` and `asset` instead), `token_id`, `status` and `tx`. `status` is `pending` (reserved, not sent), `submitted`, `confirmed`, `failed` (being retried), or `burned` once the token has been sold back or shipped.

**failure\_reason** `string | null`

Why an order is `mint_failed`, `expired`, `refund_due` or `refunded`; otherwise null.

**created\_at** `string`

**quantity** `integer`

Multi-pack orders only.

**unit\_price** `number`

Multi-pack orders only.

**units** `object[]`

Multi-pack orders only: each unit in the single-order shape plus `batch_id` and `unit` (1 to `quantity`), with its own `pull` and `token`.

**batch\_id** `string`

On a unit only: the multi-pack order's `id`.

**unit** `integer`

On a unit only: its number, 1 to `quantity`.

This response never includes the `payment` object: replay [Create an order](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-order.md) with the same `Idempotency-Key` to get it back.

## Errors

| Status | Code | When |
| - | - | - |
| `404` | `UNKNOWN_ORDER` | No such order in your program (by id or `Idempotency-Key`) |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v2/orders/okx-ord-7f3a9c21 \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "order": {
    "order_id": "okx-ord-7f3a9c21",
    "id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
    "status": "minted",
    "pack_type": "bronze",
    "category": "pokemon",
    "odds": "standard",
    "price": 25,
    "recipient": "0x8f3c...e21a",
    "mint_chain": "evm:196",
    "paid_at": "2026-11-16T18:04:40.002Z",
    "pull": {
      "card_id": "a1c4...",
      "category": "pokemon",
      "name": "Charizard ex 199/165 PSA 10",
      "value": 412.5,
      "pulled_at": "2026-11-16T18:04:41.317Z"
    },
    "token": {
      "chain": "evm:196",
      "contract": "0x7b1e...c0de",
      "token_id": "81264573985362058461377125337283195667",
      "status": "confirmed",
      "tx": "0x9f2a..."
    },
    "failure_reason": null,
    "created_at": "2026-11-16T18:02:11.420Z"
  }
}
```

```json 404 theme={null}
{ "error": "Unknown order", "code": "UNKNOWN_ORDER" }
```


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