Get vault

The cards you hold, each with the pull it came from and its CatchBack offer right now.

GET /api/partner/v1/vault

cURL

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

200

{
  "category": "pokemon",
  "page": 1,
  "per_page": 100,
  "total": 1,
  "cards": [
    {
      "card_id": "0e94dc61-…",
      "pull_id": "d9504d3f-…",
      "pulled_at": "2026-09-29T19:56:28Z",
      "item": {
        "id": "0e94dc61-…",
        "category": "pokemon",
        "name": "Greavard",
        "grading_company": "PSA",
        "grading_rank": 9,
        "cert_number": "84512377",
        "market_value": 38.43,
        "front_image": "https://…",
        "back_image": "https://…",
        "render_image": "https://…",
        "image_url": "https://…"
      },
      "value": 38.43,
      "listed": false,
      "catchback": { "amount": 30.74, "rate": 0.8, "basis_value": 38.43, "locked_value_until": "2026-10-06T19:56:28Z" }
    }
  ]
}

Scope: read:account · MCP tool: get_vault

Cards in your vault or listed on the marketplace. Cards that have shipped are not included.

category · string · default: "pokemon"

pokemon, onepiece, sports, riftbound or watches.

page · integer · default: "1"

1-based.

per_page · integer · default: "100"

1–200.

Response

category · string

page · integer

per_page · integer

total · integer

cards · object[]

Show held card

card_id · string

pull_id · string | null

The pull the card came from. Sell back needs it.

pulled_at · string | null

item · object

A card object.

value · number

Current market value.

listed · boolean

Listed on the marketplace.

catchback · object | null

The sell-back offer right now: amount, rate, basis_value (the value the offer is based on) and locked_value_until. null while the card is listed. Delist it first.

For 7 days after you acquire a card, its offer is based on its value when you acquired it, fixed whether the market moves up or down (locked_value_until). After that it follows the current market value. See Liquidity.

cURL

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

200

{
  "category": "pokemon",
  "page": 1,
  "per_page": 100,
  "total": 1,
  "cards": [
    {
      "card_id": "0e94dc61-…",
      "pull_id": "d9504d3f-…",
      "pulled_at": "2026-09-29T19:56:28Z",
      "item": {
        "id": "0e94dc61-…",
        "category": "pokemon",
        "name": "Greavard",
        "grading_company": "PSA",
        "grading_rank": 9,
        "cert_number": "84512377",
        "market_value": 38.43,
        "front_image": "https://…",
        "back_image": "https://…",
        "render_image": "https://…",
        "image_url": "https://…"
      },
      "value": 38.43,
      "listed": false,
      "catchback": { "amount": 30.74, "rate": 0.8, "basis_value": 38.43, "locked_value_until": "2026-10-06T19:56:28Z" }
    }
  ]
}