curl "https://catchbackcards.com/api/partner/v2/catalog/packs/pool?pack_type=bronze&category=pokemon&odds=hot" \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"pack_type": "bronze",
"name": "Bronze Pack",
"category": "pokemon",
"price": 25,
"odds": "hot",
"label": "Hot",
"tagline": "Fewer hits, bigger chase",
"available": true,
"fresh_buyback_rate": 1,
"consolation_probability": null,
"bands": [
{ "band": "7.5-15", "min_value": 7.5, "max_value": 15, "odds": 0.61, "cards": 380 },
{ "band": "250-1000", "min_value": 250, "max_value": 1000, "odds": 0.004, "cards": 41 }
],
"odds_choices": [
{ "odds": "standard", "label": "Standard", "available": true },
{ "odds": "hot", "label": "Hot", "available": true },
{ "odds": "chill", "label": "Chill", "available": true },
{ "odds": "classic", "label": "Classic", "available": true }
],
"total_cards": 1043,
"cards": [
{ "id": "0e94dc61-...", "category": "pokemon", "name": "Charizard ex", "grading_company": "PSA", "grading_rank": 10, "market_value": 410, "render_image": "https://...", "band": "250-1000" }
]
}
{ "error": "bronze sells standard, hot, chill, classic", "code": "BAD_ODDS", "odds": ["standard", "hot", "chill", "classic"] }
Packs & orders
Get a pack's odds and pool
What one pack can pull at one odds choice: the value bands and their chances, whether those odds are selling, and every item.
GET
/
api
/
partner
/
v2
/
catalog
/
packs
/
pool
curl "https://catchbackcards.com/api/partner/v2/catalog/packs/pool?pack_type=bronze&category=pokemon&odds=hot" \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"pack_type": "bronze",
"name": "Bronze Pack",
"category": "pokemon",
"price": 25,
"odds": "hot",
"label": "Hot",
"tagline": "Fewer hits, bigger chase",
"available": true,
"fresh_buyback_rate": 1,
"consolation_probability": null,
"bands": [
{ "band": "7.5-15", "min_value": 7.5, "max_value": 15, "odds": 0.61, "cards": 380 },
{ "band": "250-1000", "min_value": 250, "max_value": 1000, "odds": 0.004, "cards": 41 }
],
"odds_choices": [
{ "odds": "standard", "label": "Standard", "available": true },
{ "odds": "hot", "label": "Hot", "available": true },
{ "odds": "chill", "label": "Chill", "available": true },
{ "odds": "classic", "label": "Classic", "available": true }
],
"total_cards": 1043,
"cards": [
{ "id": "0e94dc61-...", "category": "pokemon", "name": "Charizard ex", "grading_company": "PSA", "grading_rank": 10, "market_value": 410, "render_image": "https://...", "band": "250-1000" }
]
}
{ "error": "bronze sells standard, hot, chill, classic", "code": "BAD_ODDS", "odds": ["standard", "hot", "chill", "classic"] }
Scope:
nft:orders
What one pack can pull at one odds choice: the value bands with their chances, whether those odds are selling right now, and every item a pull can produce. This is the same information as the odds panel in our app, so show it to your customers before they buy.
A
pack_type from List packs.As for List packs.
Response
The sell-back rate in the fresh window, as a fraction (
1 = 100%). See Sell-back.band (its key, e.g. 7.5-15), min_value, max_value, odds (the chance, 0 to 1, of a pull landing in that band at these odds) and cards (how many items sit in it). A band at 0 can’t pull at these odds.Every item a pull can produce at these odds, highest value first, each with the
band it sits in. Each item carries its catalog fields (name, set, year, grade, cert, images, market_value).Packs that sell only their own odds
A pack that sells only its own odds answersodds: "classic" with its own band shape:
bands[]withbucket_id,label,min_value,max_value,odds,is_consolationandhittable_cards;cards[]withbucket_id;chase:{ card, probability, odds_label, label, ends_at }when a chase item is on offer, else null;odds_choices: [{ "odds": "classic", "label": "Classic", "available": true }], the same shape as every other pack.
Errors
| Status | Code | When |
|---|---|---|
400 | BAD_PACK | pack_type missing |
400 | BAD_CATEGORY | Unknown category |
400 | BAD_ODDS | odds isn’t standard, hot, chill or classic, or the pack doesn’t sell it; in the second case odds lists the choices it sells |
404 | PACK_NOT_OFFERED | That pack isn’t sold through your program |
409 | ODDS_UNAVAILABLE | Those odds aren’t selling right now |
curl "https://catchbackcards.com/api/partner/v2/catalog/packs/pool?pack_type=bronze&category=pokemon&odds=hot" \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"pack_type": "bronze",
"name": "Bronze Pack",
"category": "pokemon",
"price": 25,
"odds": "hot",
"label": "Hot",
"tagline": "Fewer hits, bigger chase",
"available": true,
"fresh_buyback_rate": 1,
"consolation_probability": null,
"bands": [
{ "band": "7.5-15", "min_value": 7.5, "max_value": 15, "odds": 0.61, "cards": 380 },
{ "band": "250-1000", "min_value": 250, "max_value": 1000, "odds": 0.004, "cards": 41 }
],
"odds_choices": [
{ "odds": "standard", "label": "Standard", "available": true },
{ "odds": "hot", "label": "Hot", "available": true },
{ "odds": "chill", "label": "Chill", "available": true },
{ "odds": "classic", "label": "Classic", "available": true }
],
"total_cards": 1043,
"cards": [
{ "id": "0e94dc61-...", "category": "pokemon", "name": "Charizard ex", "grading_company": "PSA", "grading_rank": 10, "market_value": 410, "render_image": "https://...", "band": "250-1000" }
]
}
{ "error": "bronze sells standard, hot, chill, classic", "code": "BAD_ODDS", "odds": ["standard", "hot", "chill", "classic"] }

