Skip to main content

Get a card

Fetch the details of a single card.

HTTP Request#

GET https://api.pokemontcg.io/v2/cards/<id>

URL Parameters#

ParameterDescription
idThe Id of the card

Body Parameters#

None

Query Parameters#

All query parameters are optional.

ParameterDescriptionDefault Value
selectA comma delimited list of fields to return in the response (ex. ?select=id,name). By default, all fields are returned if this query parameter is not used.

Code Samples#

card = Card.find('xy1-1')

Sample Response#

{
"data": {
"id": "xy1-1",
"name": "Venusaur-EX",
"supertype": "Pokémon",
"subtypes": [
"Basic",
"EX"
],
"hp": "180",
"types": [
"Grass"
],
"evolvesTo": [
"M Venusaur-EX"
],
"rules": [
"Pokémon-EX rule: When a Pokémon-EX has been Knocked Out, your opponent takes 2 Prize cards."
],
"attacks": [
{
"name": "Poison Powder",
"cost": [
"Grass",
"Colorless",
"Colorless"
],
"convertedEnergyCost": 3,
"damage": "60",
"text": "Your opponent's Active Pokémon is now Poisoned."
},
{
"name": "Jungle Hammer",
"cost": [
"Grass",
"Grass",
"Colorless",
"Colorless"
],
"convertedEnergyCost": 4,
"damage": "90",
"text": "Heal 30 damage from this Pokémon."
}
],
"weaknesses": [
{
"type": "Fire",
"value": "×2"
}
],
"retreatCost": [
"Colorless",
"Colorless",
"Colorless",
"Colorless"
],
"convertedRetreatCost": 4,
"set": {
"id": "xy1",
"name": "XY",
"series": "XY",
"printedTotal": 146,
"total": 146,
"legalities": {
"unlimited": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "XY",
"releaseDate": "2014/02/05",
"updatedAt": "2018/03/04 10:35:00",
"images": {
"symbol": "https://images.pokemontcg.io/xy1/symbol.png",
"logo": "https://images.pokemontcg.io/xy1/logo.png"
}
},
"number": "1",
"artist": "Eske Yoshinob",
"rarity": "Rare Holo EX",
"nationalPokedexNumbers": [
3
],
"legalities": {
"unlimited": "Legal",
"expanded": "Legal"
},
"images": {
"small": "https://images.pokemontcg.io/xy1/1.png",
"large": "https://images.pokemontcg.io/xy1/1_hires.png"
},
"tcgplayer": {
"url": "https://prices.pokemontcg.io/tcgplayer/xy1-1",
"updatedAt": "2021/07/09",
"prices": {
"holofoil": {
"low": 1.0,
"mid": 3.46,
"high": 12.95,
"market": 3.32,
"directLow": 2.95
}
}
}
}
}