Search shop cards

Every card currently for sale in the CatchBack shop, paginated.

GET /api/partner/v1/catalog/cards

cURL

curl "https://catchbackcards.com/api/partner/v1/catalog/cards?category=pokemon&page=1&per_page=100" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "category": "pokemon",
  "page": 1,
  "per_page": 100,
  "total": 5210,
  "cards": [
    {
      "id": "0e94dc61-…",
      "category": "pokemon",
      "name": "Greavard",
      "set": "Pokemon Svi En-Scarlet & Violet",
      "grading_company": "PSA",
      "grading_rank": 9,
      "slab_label": "2023 Scarlet & Violet Greavard",
      "cert_number": "84512377",
      "market_value": 38.43,
      "price": 38.43,
      "sale_status": "available in shop",
      "front_image": "https://…",
      "back_image": "https://…",
      "render_image": "https://…",
      "image_url": "https://…"
    }
  ]
}

Scope: read:catalog · MCP tool: search_cards

The purchasable inventory: the same pool our storefront and pack openings draw from. Paginate by incrementing page until you’ve fetched total cards. Ordering is stable (id ascending) within a sync, but the set changes between syncs, because the inventory is point-in-time.

category · string · default: "pokemon"

pokemon, onepiece, sports, riftbound or watches.

page · integer · default: "1"

1-based.

per_page · integer · default: "500"

1–1000.

Response

category · string

page · integer

per_page · integer

total · integer

cards · object[]

Card objects, each with sale_status, the pool the card sits in.

cURL

curl "https://catchbackcards.com/api/partner/v1/catalog/cards?category=pokemon&page=1&per_page=100" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "category": "pokemon",
  "page": 1,
  "per_page": 100,
  "total": 5210,
  "cards": [
    {
      "id": "0e94dc61-…",
      "category": "pokemon",
      "name": "Greavard",
      "set": "Pokemon Svi En-Scarlet & Violet",
      "grading_company": "PSA",
      "grading_rank": 9,
      "slab_label": "2023 Scarlet & Violet Greavard",
      "cert_number": "84512377",
      "market_value": 38.43,
      "price": 38.43,
      "sale_status": "available in shop",
      "front_image": "https://…",
      "back_image": "https://…",
      "render_image": "https://…",
      "image_url": "https://…"
    }
  ]
}