---
title: "Find card by ID"
method: GET
path: "/cards/{cardId}"
tags: ["cards"]
---

# Find card by ID

`GET /cards/{cardId}`

Returns detailed information about a specified card

## Path parameters

- `cardId` string, required

## Response `200`

Successful request

- Card — Detailed information about a Pokemon TCG card, including game mechanics
  - `id` string, required — Unique identifier of the card
  - `localId` string, required — Card number within its set
  - `image` string — URL to the card image
  - `name` string, required — Name of the card (including any suffix)
  - `illustrator` union — Artist who illustrated the card
    - string
    - unknown
  - `category` string, required — Card category (Pokemon, Trainer, or Energy)
  - `rarity` string, required — Card rarity (Common, Uncommon, Rare, etc.)
  - `set` SetResume, required — Basic information about a Pokemon TCG set
    - `id` string, required — Unique identifier of the set
    - `name` string, required — Name of the set
    - `logo` string — URL to the logo of the set
    - `symbol` string — URL to the set symbol
    - `cardCount` object, required — Statistics about the number of cards in this set
      - `total` number, required — Total number of cards in the set including variants
      - `official` number, required — Number of cards officially numbered in the set
  - `variants` object — Indicates which variants of this card exist (overrides set variants)
    - `normal` boolean, required — Indicates whether a normal variant exists
    - `reverse` boolean, required — Indicates whether a reverse holo variant exists
    - `holo` boolean, required — Indicates whether a holo variant exists
    - `firstEdition` boolean, required — Indicates whether a first edition variant exists
    - `wPromo` boolean, required — Indicates whether a promotional variant exists
  - `variant_detailed` object[], nullable — Detailed information about a card variant
    - `type` string, required — The type of variant (e.g., normal, reverse, holo, etc.)
    - `size` string, nullable — The size of the variant (e.g., standard, jumbo, etc.)
    - `stamp` string[], nullable — The stamps of the variant (e.g., 'Staff', 'Pokemon-Centre', etc.)
    - `foil` string, nullable — The foil of the variant (e.g., 'Pokeball', 'MasterBall', etc.)
  - `hp` number, nullable — Hit Points (HP) of the Pokemon
  - `types` union — Energy types of the Pokemon
    - string[]
    - string[]
  - `evolveFrom` union — Name of the Pokemon this evolves from
    - string
    - unknown
  - `stage` union — Evolution stage (Basic, Stage 1, Stage 2, etc.)
    - string
    - unknown
  - `suffix` union — Special card suffix (EX, GX, V, etc.)
    - string
    - unknown
  - `item` object — Pokemon's held item information
    - `name` string, required — Name of the held item
    - `effect` string, required — Effect of the held item
  - `trainerType` union — Type of trainer card (Item, Supporter, Stadium, Tool)
    - string
    - unknown
  - `energyType` union — Type of energy card (Basic, Special)
    - string
    - unknown
  - `regulationMark` union — Regulation mark on cards (introduced in Sword & Shield)
    - string
    - unknown
  - `legal` object, required — Information about tournament legality of this card
    - `standard` boolean — Indicates whether this card is legal in standard format tournaments
    - `expanded` boolean — Indicates whether this card is legal in expanded format tournaments
  - `description` union — Descriptive text or flavor text on the card
    - string
    - unknown
  - `level` union — Level of the Pokemon (can be a string 'X' for LEVEL-UP cards)
    - number
    - string
  - `abilities` object[] — Pokemon abilities (Poké-Power, Poké-Body, Ability, etc.)
    - `type` string — Type of ability (Poké-Power, Poké-Body, Ability, etc.)
    - `name` string — Name of the ability
    - `effect` union — Effect text of the ability
      - string
      - unknown
  - `attacks` object[] — Pokemon attacks
    - `cost` string[] — Energy cost to use this attack
    - `name` string, required — Name of the attack
    - `effect` union — Effect text of the attack
      - string
      - unknown
    - `damage` union — Base damage of the attack (can be string for special damage)
      - number
      - string
  - `retreat` union — Retreat cost of the Pokemon
    - number
    - unknown
  - `dexId` number[] — Pokedex number(s) of the Pokemon
  - `weaknesses` WeakRes[] — Types the Pokemon is weak against
    - object[]
      - `type` string, required
      - `value` union
        - string
        - unknown
  - `resistances` WeakRes[] — Types the Pokemon is resistant to
    - object[]
      - `type` string, required
      - `value` union
        - string
        - unknown
  - `boosters` Booster[] — Boosters in which this card is available
    - `id` string, required — The booster ID using format boo_<set_id>-<booster_name>
    - `name` string, required — The name of the booster
    - `logo` union — URL to the logo of the booster
      - string
      - unknown
    - `artwork_front` union — URL to the front artwork of the booster pack
      - string
      - unknown
    - `artwork_back` union — URL to the back artwork of the booster pack
      - string
      - unknown
  - `updated` string, date-time, required — Timestamp of when this card data was last updated

## Other responses

- `400` — The request was invalid
- `404` — The specified resource was not found
- `500` — An unexpected error occurred on the server

---

[API](https://skmtc.net/tcgdex/apis/tcgdex-api.md) · [All operations](https://skmtc.net/tcgdex/apis/tcgdex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tcgdex/tcgdex-api/versions/cc386057cff5/schema)