Get account

Your balance, and where you stand against your purchase limits.

GET /api/partner/v1/account

cURL

curl https://catchbackcards.com/api/partner/v1/account \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "username": "acme-cards",
  "balance": 189953.5,
  "limits": {
    "packs_today": 4,
    "max_packs_per_day": 100,
    "packs_left_today": 96,
    "resets_at": "2026-09-30T00:00:00.000Z",
    "min_seconds_between_purchases": 60,
    "next_purchase_at": "2026-09-29T20:24:12.000Z"
  }
}

Scope: read:account · MCP tool: get_balance

Enough to plan your next purchase without hitting a 429.

Response

username · string

balance · number

CatchCoins balance in USD.

limits · object

Show limits

packs_today · integer

Packs opened this UTC day.

max_packs_per_day · integer

packs_left_today · integer

resets_at · string

Next midnight UTC.

min_seconds_between_purchases · integer

next_purchase_at · string

The earliest your next purchase is allowed.

cURL

curl https://catchbackcards.com/api/partner/v1/account \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "username": "acme-cards",
  "balance": 189953.5,
  "limits": {
    "packs_today": 4,
    "max_packs_per_day": 100,
    "packs_left_today": 96,
    "resets_at": "2026-09-30T00:00:00.000Z",
    "min_seconds_between_purchases": 60,
    "next_purchase_at": "2026-09-29T20:24:12.000Z"
  }
}