Card object
The Card object holds metadata for a trading card. Pricing lives on its variants array.
Properties
| Property | Type | Description |
|---|---|---|
| uuid | string | Stable, canonical identifier for the card (UUID v5). Recommended as your primary key — see Identifiers. |
| id | string | Legacy human-readable slug. Frequently referred to as cardId. Still queryable, but no longer the recommended key. |
| name | string | Name of the card. |
| game | string | Name of the game the card belongs to (e.g. 'Pokemon'). |
| set | string | Unique ID of the set the card belongs to. |
| set_name | string | Name of the set the card belongs to. |
| number | string | Card number within the set. |
| tcgplayerId | string | TCGplayer product ID. |
| mtgjsonId | string | MTGJSON UUID for this card. |
| scryfallId | string | Scryfall UUID for this card. |
| rarity | string | Rarity of the card (e.g. 'Common', 'Rare', 'Promo'). |
| details | string | null | Additional card-specific details (when applicable). |
| variants | Variant[] | Array of Variant objects with pricing. |
Cards do not directly contain pricing. Pricing is stored on each Variant within the
variants array.Card IDs
Every card carries a stable uuid and a legacy human-readable id (the cardId, structured as game-set-name-rarity). Both can be used for direct lookups via the /cards endpoint, but we recommend preferring uuid. See Identifiers for the full breakdown and how slugs are composed.
Note: multiple variants of the same card may exist, each with its own variant ID.
Example
card.json
{
"uuid": "f8c3de3d-1fea-5d7c-a8b0-29f63c4c3454",
"id": "pokemon-battle-academy-fire-energy-22-charizard-stamped",
"name": "Fire Energy (#22 Charizard Stamped)",
"game": "Pokemon",
"set": "battle-academy-pokemon",
"set_name": "Battle Academy",
"number": "N/A",
"tcgplayerId": "219042",
"rarity": "Promo",
"details": null,
"variants": [
{
"uuid": "a1b2c3d4-5e6f-5a7b-8c9d-0e1f2a3b4c5d",
"id": "pokemon-battle-academy-fire-energy-22-charizard-stamped_near-mint",
"printing": "Normal",
"condition": "Near Mint",
"price": 4.99,
"lastUpdated": 1743100261
}
]
}