Zum Inhalt springen

The Card object

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

The Card object is the core data structure used throughout the TCGdx API. It represents a single Pokémon Trading Card Game card with all its properties, variants, and associated metadata.

All cards share common properties, with additional fields specific to their category:

Properties shared by all cards regardless of category:

PropertyTypeRequiredDescription
idStringUnique identifier for the card (e.g., “swsh3-136”)
localIdString or NumberCard number within its set
nameStringOfficial card name
imageStringCard image URL (see Assets)
categoryStringCard type: “Pokemon”, “Energy”, or “Trainer”
illustratorStringArtist who illustrated the card
rarityStringCard rarity (Common, Uncommon, Rare, etc.)
setSetBriefSet information (see Sets API)
variantsObjectAvailable card variants
boostersArrayBooster packs containing this card (null if available in all boosters)
pricingObjectMarket pricing information
updatedString (ISO9601)Indicate when is the last time the card data was updated (excluding pricing infos)
PropertyTypeRequiredDescription
variants.normalBooleanStandard non-foil version available
variants.reverseBooleanReverse holofoil version available
variants.holoBooleanHolofoil version available
variants.firstEditionBooleanFirst edition printing available
PropertyTypeRequiredDescription
boosters[].idStringUnique booster identifier
boosters[].nameStringLocalized booster name
boosters[].logoStringBooster pack logo image
boosters[].artwork_frontStringFront artwork image
boosters[].artwork_backStringBack artwork image

Market pricing information from multiple sources:

PropertyTypeRequiredDescription
pricing.tcgplayerObjectTCGPlayer marketplace data
pricing.cardmarketObjectCardmarket pricing data
PropertyTypeRequiredDescription
pricing.tcgplayer.updatedNumberIndicate when is the last time it was fetched
pricing.tcgplayer.unitNumberIndicate the unit in which the card is sold
pricing.tcgplayer.normalObjectStandard non-foil cards
pricing.tcgplayer.holofoilObjectHolofoil finish cards
pricing.tcgplayer.reverse-holofoilObjectReverse holofoil cards
pricing.tcgplayer.1st-editionObjectFirst edition cards
pricing.tcgplayer.1st-edition-holofoilObjectFirst edition holofoil cards
pricing.tcgplayer.unlimitedObjectUnlimited edition cards
pricing.tcgplayer.unlimited-holofoilObjectUnlimited holofoil cards

TCGPlayer data is organized by card variant. Each variant may contain:

PropertyTypeRequiredDescription
lowPriceNumberLowest available price
midPriceNumberMedian market price
highPriceNumberHighest available price
marketPriceNumberCurrent market price
directLowPriceNumberLowest direct seller price

European market data with separate pricing for foil and non-foil variants:

PropertyTypeRequiredDescription
pricing.cardmarket.updatedNumberIndicate when is the last time it was fetched
pricing.cardmarket.unitNumberIndicate the unit in which the card is sold
pricing.cardmarket.avgNumberAverage selling price (non-foil)
pricing.cardmarket.lowNumberLowest market price (non-foil)
pricing.cardmarket.trendNumberTrend price from charts (non-foil)
pricing.cardmarket.avg1NumberAverage price (last 24 hours)
pricing.cardmarket.avg7NumberAverage price (last 7 days)
pricing.cardmarket.avg30NumberAverage price (last 30 days)
pricing.cardmarket.avg-holoNumberAverage selling price (foil)
pricing.cardmarket.low-holoNumberLowest market price (foil)
pricing.cardmarket.trend-holoNumberTrend price from charts (foil)
pricing.cardmarket.avg1-holoNumberAverage price (last 24 hours, foil)
pricing.cardmarket.avg7-holoNumberAverage price (last 7 days, foil)
pricing.cardmarket.avg30-holoNumberAverage price (last 30 days, foil)

Additional properties for Pokémon cards (includes all common properties):

PropertyTypeRequiredDescription
category”Pokemon”Always “Pokemon” for these cards
dexIdArray of NumberNational Pokédex ID(s) of the Pokémon
hpNumberHit Points of the Pokémon
typesArray of StringPokémon types (Fire, Water, Grass, etc.)
evolveFromStringName of the Pokémon it evolves from
descriptionStringFlavor text description
levelStringPokémon level (for LV.X cards, level is X)
stageStringEvolution stage (Basic, Stage1, Stage2)
suffixStringAdditional card identifiers
itemObjectHeld item information
item.nameStringItem name
item.effectStringItem effect description

Additional properties for Trainer cards (includes all common properties):

PropertyTypeRequiredDescription
category”Trainer”Always “Trainer” for these cards
effectStringCard effect text
trainerTypeStringType of trainer card

Additional properties for Energy cards (includes all common properties):

PropertyTypeRequiredDescription
category”Energy”Always “Energy” for these cards
effectStringCard effect text
energyTypeStringType of energy card
TypeDescription
BasicStandard single-type energy
SpecialMulti-type or special effect energy

Complete Pokémon card response:

{
"category": "Pokemon",
"id": "swsh3-136",
"illustrator": "tetsuya koizumi",
"image": "https://assets.tcgdex.net/en/swsh/swsh3/136",
"localId": "136",
"name": "Furret",
"rarity": "Uncommon",
"set": {
"cardCount": {
"official": 189,
"total": 201
},
"id": "swsh3",
"logo": "https://assets.tcgdex.net/en/swsh/swsh3/logo",
"name": "Darkness Ablaze",
"symbol": "https://assets.tcgdex.net/univ/swsh/swsh3/symbol"
},
"variants": {
"firstEdition": false,
"holo": false,
"normal": true,
"reverse": true,
"wPromo": false
},
"dexId": [
162
],
"hp": 110,
"types": [
"Colorless"
],
"evolveFrom": "Sentret",
"description": "It makes a nest to suit its long and skinny body. The nest is impossible for other Pokémon to enter.",
"stage": "Stage1",
"attacks": [
{
"cost": [
"Colorless"
],
"name": "Feelin' Fine",
"effect": "Draw 3 cards."
},
{
"cost": [
"Colorless"
],
"name": "Tail Smash",
"effect": "Flip a coin. If tails, this attack does nothing.",
"damage": 90
}
],
"weaknesses": [
{
"type": "Fighting",
"value": "×2"
}
],
"retreat": 1,
"regulationMark": "D",
"legal": {
"standard": false,
"expanded": true
},
"updated": "2024-02-04T22:55:32+02:00",
"pricing": {
"cardmarket": {
"updated": "2025-08-05T00:42:15.000Z",
"unit": "EUR",
"avg": 0.08,
"low": 0.02,
"trend": 0.08,
"avg1": 0.03,
"avg7": 0.08,
"avg30": 0.08,
"avg-holo": 0.27,
"low-holo": 0.03,
"trend-holo": 0.21,
"avg1-holo": 0.19,
"avg7-holo": 0.19,
"avg30-holo": 0.26
},
"tcgplayer": {
"updated": "2025-08-05T20:07:54.000Z",
"unit": "USD",
"normal": {
"lowPrice": 0.02,
"midPrice": 0.17,
"highPrice": 25.09,
"marketPrice": 0.09,
"directLowPrice": 0.04
},
"reverse": {
"lowPrice": 0.09,
"midPrice": 0.26,
"highPrice": 5.17,
"marketPrice": 0.23,
"directLowPrice": 0.23
}
}
}
}