Card object
The Card object holds metadata for a trading card. Pricing lives on its variants array.
Properties
| Property | Type | Description |
|---|---|---|
| id | string | Unique identifier for the card. Frequently referred to as 'cardId'. |
| 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 has a unique id (the cardId). It is structured as game-set-name-rarity and can be used for direct lookups via the /cards endpoint.
Note: multiple variants of the same cardId may exist, each with its own variant ID.
Example
card.json
{
"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": [
{
"id": "pokemon-battle-academy-fire-energy-22-charizard-stamped_near-mint",
"printing": "Normal",
"condition": "Near Mint",
"price": 4.99,
"lastUpdated": 1743100261
}
]
}