> ## 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 by its id, including one that is still running, with every pull or card in it.

Scope: `read:account` · MCP tool: `get_order`

One order on your account, with the same fields as in [List orders](https://catchbackcards.mintlify.site/partner-api/endpoints/list-orders.md) plus what it contains: a pack purchase's pulls, or the card for any other order.

It answers while an order is still running. After a timeout, or a `409 IDEMPOTENCY_IN_PROGRESS` that carries the order's `checkout_id`, follow the order here rather than resending it in a tight loop: it shows `pending` until the order completes or we close it, and a pack order's pulls as soon as they have landed. An order [held for review](https://catchbackcards.mintlify.site/partner-api/idempotency.md#purchases-that-need-review) stays `pending` until we settle it. Settling removes it, so this then answers `404` and the order id is free to send again: check your balance before you do. See [Idempotency](https://catchbackcards.mintlify.site/partner-api/idempotency.md).

**checkout\_id** `string` *required*

The `checkout_id` that [Buy packs](https://catchbackcards.mintlify.site/partner-api/endpoints/buy-packs.md) or [Buy a card](https://catchbackcards.mintlify.site/partner-api/endpoints/buy-card.md) returned, the `transaction_id` of a [sell-back](https://catchbackcards.mintlify.site/partner-api/endpoints/sell-back.md), or any order's `checkout_id` from List orders. A UUID.

## Response

Every field of an order in [List orders](https://catchbackcards.mintlify.site/partner-api/endpoints/list-orders.md), plus:

**pulls** `object[]`

A pack purchase's pulls, in order. Empty for any other order.

**pull**

**pull\_id** `string`

**kind** `string | null`

`card`, or `sealed_pack` for a sealed product (a pull from the Starter or a sealed mystery pack, or a consolation pull). `null` if we can't find the pull.

**item** `object | null`

The card as it is now: a [card object](https://catchbackcards.mintlify.site/partner-api/card-object.md), with today's images and market value. A sealed pack is `{ id, name, set, category, image_url }`. `null` if we can't load it.

**value** `number | null`

Market value at the moment of the pull.

**hit** `object | null`

`rarity_tier`, `bucket`, `bucket_odds`, `is_chase` and `chase_label`, as the purchase returned them. `null` while the order is still running, and for an order we closed after its response was lost.

**item** `object | null`

The card, for a card buy, a sell-back or a sale: a [card object](https://catchbackcards.mintlify.site/partner-api/card-object.md) as it is now. `null` for a pack purchase, or if we can't load the card.

**payout\_rate** `number | null`

Sell-backs only: the rate the sell-back paid at.

**basis\_value** `number | null`

Sell-backs only: the value the payout was based on.

A pull here has no `catchback` offer and no `proof`. For a card's offer right now, read [Get vault](https://catchbackcards.mintlify.site/partner-api/endpoints/get-vault.md). To check a pull, see [Verify a pull](https://catchbackcards.mintlify.site/partner-api/verify-a-pull.md).

## Errors

| Status | When |
| - | - |
| `403` | The key lacks `read:account` or isn't linked to an account |
| `404` | No order with this id on your account. An unknown id, a malformed one, another account's order and a held order we've since settled all look the same |
| `500` | We couldn't load the order. Retry with backoff |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v1/orders/3e1ab17c-e93b-4a4e-b1f6-7b0719882a41 \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "checkout_id": "3e1ab17c-…",
  "order_id": "order-1042",
  "type": "pack_purchase",
  "status": "completed",
  "created_at": "2026-10-20T04:54:57.373+00:00",
  "completed_at": "2026-10-20T04:54:58.563+00:00",
  "amount": 25,
  "fee": 0,
  "balance_change": -25,
  "reconciled": false,
  "pack_type": "bronze",
  "quantity": 1,
  "pull_ids": ["e9d27918-…"],
  "card_id": null,
  "listing_id": null,
  "transaction_id": null,
  "pulls": [
    {
      "pull_id": "e9d27918-…",
      "kind": "card",
      "item": {
        "id": "e3d7148d-…",
        "category": "pokemon",
        "name": "Pyroar",
        "grading_company": "PSA",
        "grading_rank": 10,
        "market_value": 20,
        "front_image": "https://…"
      },
      "value": 20,
      "hit": { "rarity_tier": "starter", "bucket": "P0", "bucket_odds": 0.72, "is_chase": false, "chase_label": null }
    }
  ],
  "item": null,
  "payout_rate": null,
  "basis_value": null
}
```


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