List packs

Exactly the packs you can buy, at the price you’ll be charged.

GET /api/partner/v1/catalog/packs

cURL

curl "https://catchbackcards.com/api/partner/v1/catalog/packs?category=pokemon" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "category": "pokemon",
  "packs": [
    {
      "pack_type": "bronze",
      "name": "Bronze Pack",
      "price": 25,
      "available": true,
      "max_quantity": 10,
      "risk_levels": ["chill", "standard", "aggressive"]
    },
    {
      "pack_type": "starter",
      "name": "Starter Pack",
      "price": 8,
      "available": false,
      "reason": "Starter pack temporarily out of stock",
      "max_quantity": 1,
      "risk_levels": ["chill", "standard", "aggressive"]
    }
  ]
}

Scope: read:catalog · MCP tool: list_packs

Every pack this endpoint returns is one Buy packs will sell you, at the listed price. Packs you can never buy are left out. A pack that is only out of stock right now stays in with available: false and a reason.

category · string · default: "pokemon"

pokemon, onepiece, sports, riftbound or watches.

Response

category · string

packs · object[]

Show pack

pack_type · string

The id to send to Buy packs and Get a pack’s pool.

name · string

price · number

Price per pack in USD. This is what you’re charged.

available · boolean

Whether the pack can be opened right now.

reason · string

Why it can’t, when available is false.

max_quantity · integer

Most packs you can open in one request.

risk_levels · string[]

The risk levels the pack opens at.

cURL

curl "https://catchbackcards.com/api/partner/v1/catalog/packs?category=pokemon" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "category": "pokemon",
  "packs": [
    {
      "pack_type": "bronze",
      "name": "Bronze Pack",
      "price": 25,
      "available": true,
      "max_quantity": 10,
      "risk_levels": ["chill", "standard", "aggressive"]
    },
    {
      "pack_type": "starter",
      "name": "Starter Pack",
      "price": 8,
      "available": false,
      "reason": "Starter pack temporarily out of stock",
      "max_quantity": 1,
      "risk_levels": ["chill", "standard", "aggressive"]
    }
  ]
}