BinderDex API

BinderDex API

List games

GET /v1/games

GET/v1/games

List the games BinderDex serves today (Pokémon and One Piece), each with a stable slug, display name, and its current set and card counts. Use this to discover valid ?game= values for cards_search, sets_list, and market_movers before filtering by game.

Auth: send Authorization: Bearer bdx_live_... (or X-API-Key) from a server-side integration. Sandbox keys get 403 sandbox_key.

Response shape

FieldTypeRequiredDescription
dataarray<object>——
data[].card_countinteger—Cards in this game's catalog.
data[].namestring—Display name, e.g. Pokemon TCG.
data[].set_countinteger—Sets in this game's catalog.
data[].slugstring—Stable game slug, e.g. pokemon.

Example

Example responsejson
{
  "data": [
    {
      "card_count": 18420,
      "name": "Pokemon TCG",
      "set_count": 165,
      "slug": "pokemon"
    },
    {
      "card_count": 3210,
      "name": "One Piece Card Game",
      "set_count": 24,
      "slug": "one-piece"
    }
  ]
}

Possible errors

Every error below uses the Error envelope with a request ID. Retry only when the response’s documented semantics identify a temporary condition; see errors and versioning for the detailed guidance.