Card

Returned by every card endpoint. Without select you get every scalar field the catalogue holds; with select you get exactly the names you asked for, plus id, which is always present.

Relations (prices, translations, images, set, artist) are absent unless you ask for them with include. Each one is a join, so ask only for what you render. There is no legalities relation: include=legalities is rejected with 400 INVALID_INCLUDE, because a relation that always came back empty would read as a card with no legal format rather than as a gap in the catalogue.

The game-text fields carry rows since 2026-09-03. The rates below are measured, not estimated, and counted over the whole catalogue — all 52,337 cards, not a sample. They look low because they are honest: the game text we hold is English, so it lands on the 20,725 Western printings and not on the Japanese and Chinese ones, which are the larger half of the catalogue. Against Western cards alone, attacks is on 83% of them.

Fields

Example

{
  "id": "bs-4",
  "legacy_id": "base1-4",
  "name": "Charizard",
  "number": "4",
  "number_sort": 4,
  "supertype": "Pokémon",
  "subtypes": ["Stage 2"],
  "types": ["Fire"],
  "hp": 120,
  "level": null,
  "evolves_from": "Charmeleon",
  "evolves_to": [],
  "rarity": "Rare Holo",
  "regulation_mark": null,
  "flavor_text": "Spits fire that is hot enough to melt boulders. Known to unintentionally cause forest fires.",
  "abilities": [
    {
      "name": "Energy Burn",
      "text": "As often as you like during your turn (before your attack), you may turn all Energy attached to Charizard into Fire Energy for the rest of the turn. This power can't be used if Charizard is Asleep, Confused, or Paralyzed.",
      "type": "Pokemon Power"
    }
  ],
  "attacks": [
    {
      "name": "Fire Spin",
      "cost": ["Fire", "Fire", "Fire", "Fire"],
      "converted_cost": 4,
      "damage": "100",
      "text": "Discard 2 Energy cards attached to Charizard in order to use this attack."
    }
  ],
  "weaknesses": [{ "type": "Water", "value": "×2" }],
  "resistances": [{ "type": "Fighting", "value": "-30" }],
  "retreat_cost": ["Colorless", "Colorless", "Colorless"],
  "converted_retreat_cost": 3,
  "rules": [],
  "national_pokedex_numbers": [6],
  "tcgplayer_id": 42382,
  "cardmarket_id": 273699,
  "jp_twin_id": "exp-021",
  "index_eur": 556.23,
  "last_price_at": "2026-09-02T00:00:00.000Z",
  "row_version": 6,
  "created_at": "2026-05-23T14:37:01.304Z",
  "updated_at": "2026-09-03T00:17:04.527Z",
  "set_code": "bs",
  "set_name": "Base",
  "set_total": 134,
  "ptcgo_code": "BS",
  "release_date": "1999-01-09",
  "print_region": "WEST",
  "series": "Base",
  "artist_name": "Mitsuhiro Arita",
  "artist_slug": "mitsuhiro-arita"
}

What this object is for

The catalogue is an identity and provenance layer first: which printing this is, which set and region it belongs to, who drew it, what it is worth and which external ids it joins to. Since 2026-09-03 it also carries the game text — attacks, abilities, weaknesses, subtypes — for the printings we hold it for.

Until 2026-09-03 the rules-text fields were declared and empty, and this page said so. They now carry rows on the Western printings — the example above is a real response, Energy Burn and all — while the Japanese and Chinese ones still have none. Each field above states its own measured rate rather than a single headline number, because a share quoted over the whole catalogue and a share quoted over the cards it can apply to are different claims.

Getting prices onto a card

Two ways, both live. index_eur and last_price_at are already on every card row, so a price-sorted list costs one request. For the full per-source breakdown, ask for the relation:

GET /v1/cards/base1-4?include=prices

Each entry is a price object with its own source, basis, currency and date.