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

> The packs you can sell in one category, with price, odds choices, art and the chase on offer.

Scope: `nft:orders`

The packs a wallet order can buy in one category, with your program's `mint_chain`.

**category** `string` (default: pokemon)

`pokemon`, `onepiece`, `sports`, `riftbound`, `watches` or `goods`. `goods` packs hold streetwear and jewelry. Raw singles have no category of their own: they come out of other categories' packs.

## Response

**category** `string`

**mint\_chain** `string`

The chain your program mints on, e.g. `evm:196`. See [Chains](https://catchbackcards.mintlify.site/partner-api/v2/chains-and-metadata.md).

**packs** `object[]`

**pack**

**pack\_type** `string`

Pass it to [Get a pack's odds and pool](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/get-pack-pool.md) and [Create an order](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-order.md).

**name** `string`

**price** `number`

What the customer pays, in dollars.

**available** `boolean`

Mirrors the pack's shelf in our app. A pack that isn't on sale right now stays listed with `available: false` and a `reason`.

**reason** `string`

Only when `available` is false: `Out of stock`, `Odds maintenance in progress`, `Restocking` or `Not available right now`.

**odds** `string[]`

The [odds choices](https://catchbackcards.mintlify.site/partner-api/v2/odds.md) the pack sells, in the order our app's picker shows them. Whether a particular choice is selling right now is on the pool endpoint.

**default\_odds** `string`

The one an order gets when it names none (Standard wherever it is sold).

**image\_url** `string | null`

The pack art: an absolute URL, resized for display, or null.

**banner\_url** `string | null`

The pack's wide banner, or null.

**description** `string | null`

The pack's own text, or null.

**chase** `object | null`

The hand-picked chase item (bounty) the pack is offering right now, else null: `label`, `odds` (its chance per pack, formatted as a percentage), `ends_at` (null when open-ended) and `item` with its catalog fields and `market_value`.

## Errors

| Status | Code | When |
| - | - | - |
| `400` | | Unknown `category` |

Plus the errors [every endpoint can return first](https://catchbackcards.mintlify.site/partner-api/v2/authentication.md#errors-every-endpoint-can-return-first).

```bash cURL theme={null}
curl "https://catchbackcards.com/api/partner/v2/catalog/packs?category=pokemon" \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "category": "pokemon",
  "mint_chain": "evm:196",
  "packs": [
    {
      "pack_type": "bronze",
      "name": "Bronze Pack",
      "price": 25,
      "available": true,
      "odds": ["standard", "hot", "chill", "classic"],
      "default_odds": "standard",
      "image_url": "https://...",
      "banner_url": "https://...",
      "description": "Graded Pokemon slabs from $7.50 up.",
      "chase": {
        "label": "Charizard bounty",
        "odds": "0.05%",
        "ends_at": "2026-11-30T00:00:00.000Z",
        "item": { "id": "0e94dc61-...", "category": "pokemon", "name": "Charizard ex", "grading_company": "PSA", "grading_rank": 10, "render_image": "https://...", "market_value": 410 }
      }
    },
    { "pack_type": "gold", "name": "Gold Pack", "price": 100, "available": false, "reason": "Restocking", "odds": ["standard", "hot", "chill", "classic"], "default_odds": "standard", "image_url": "https://...", "banner_url": null, "description": null, "chase": null }
  ]
}
```


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