Partner API

Build on CatchBack’s graded-card inventory: browse packs and cards, open packs, and manage what you pull.

The Partner API lets companies, bots and AI agents work with CatchBack programmatically. A partner is a normal CatchBack account with an API key linked to it, so every action runs through the same code and the same rules as our own app.

Browse inventory

The packs you can buy, every card each pack can pull, and the cards for sale in the shop.

Open packs

Open packs with your CatchCoins balance and get every hit back with its CatchBack offer.

Manage what you pull

Hold cards in your vault, sell them back to us, or list them on the marketplace.

Connect an AI agent

The same actions as MCP tools, with the same key.

Basics

• Base URL: https://catchbackcards.com. All endpoints live under /api/partner/v1/.
• Auth: every request sends your key as a bearer token. See Authentication.
• Format: JSON in and out, UTF-8. Money is in US dollars as numbers (not cents). Your CatchCoins balance is also in dollars.
• Versioning: breaking changes ship under a new version prefix. A v1 response may gain new fields at any time, so build your parser to ignore fields it doesn’t know.

How a partner account works

1. You get an account and a key. We create your API key with the scopes you need and link it to your CatchBack account.
2. You fund it. You pre-fund the account with CatchCoins (we credit it when your wire lands). Purchases spend only that balance, at the same list price as everyone else.
3. Pulls land in your vault. Every card you pull is held by CatchBack in your account. From there you can keep it, sell it back at our guaranteed rates, or list it on the marketplace.

Interested in becoming a partner? Email [e-mail].

Quick start

1. See what you can buy

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

   curl "https://catchbackcards.com/api/partner/v1/catalog/packs/pool?pack_type=bronze&category=pokemon" \
     -H "Authorization: Bearer $CATCHBACK_KEY"
   
3. Open one

   curl -X POST https://catchbackcards.com/api/partner/v1/packs/purchase \
     -H "Authorization: Bearer $CATCHBACK_KEY" \
     -H "Idempotency-Key: order-0001" \
     -H "Content-Type: application/json" \
     -d '{ "pack_type": "bronze", "category": "pokemon", "quantity": 1 }'