/api/v1/pokemon/expansions/{id}/cards read:catalog 1
creditPage through one expansion’s cards. Equivalent to searching cards with `expansion.id:{id}`, but scoped by path so you can’t accidentally widen the query. Accepts the same `q`, `orderBy`, `distinct`, paging and `include` params. `language` is honoured but NOT defaulted here: an expansion id already names a language (`EB01` vs `EB01_ja`), so an English default would empty every Japanese set.
GET /api/v1/pokemon/expansions/sv3pt5/cards?page_size=10&include=prices These inputs are shared across all docs pages, so an id entered here carries over.
{
"success": true,
"data": [
{
"id": "sv3pt5-63",
"name": "Abra",
"number": "63",
"printed_number": "63",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516268",
"variants": [
{
"name": "normal",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Basic"
],
"types": [
"Psychic"
],
"hp": "50",
"attacks": [
{
"cost": [
"Psychic"
],
"converted_energy_cost": 1,
"name": "Psyshot",
"damage": "20"
}
],
"weaknesses": [
{
"type": "Darkness",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Common",
"artist": "Mitsuhiro Arita",
"pricing": {
"currency": "USD",
"market": 0.14,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 0.14
},
{
"condition": "LP",
"price": 0.13
},
{
"condition": "MP",
"price": 0.05
}
],
"graded": [
{
"company": "CGC",
"grade": "8",
"value": 10.8,
"low": 10.8,
"high": 10.8,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "9",
"value": 10,
"low": 8.5,
"high": 11.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 55.5,
"low": 47.18,
"high": 63.83,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 6,
"low": 5.1,
"high": 6.9,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 8,
"low": 6.8,
"high": 9.2,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "SGC",
"grade": "10",
"value": 35.9,
"low": 30.51,
"high": 41.29,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "down",
"percent": -22.22
}
}
},
{
"id": "sv3pt5-63vh",
"name": "Abra",
"number": "63",
"printed_number": "63",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516268",
"variants": [
{
"name": "holofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5-63vh.large.webp"
}
]
}
],
"rarity": "Common",
"artist": "Mitsuhiro Arita",
"pricing": {
"currency": "USD",
"market": 1.87,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 1.87
},
{
"condition": "LP",
"price": 0.69
},
{
"condition": "MP",
"price": 0.74
},
{
"condition": "HP",
"price": 0.56
},
{
"condition": "DMG",
"price": 0.99
}
],
"graded": [
{
"company": "CGC",
"grade": "10",
"value": 63.75,
"low": 60.63,
"high": 66.88,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8",
"value": 15,
"low": 12.75,
"high": 17.25,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8.5",
"value": 11,
"low": 9.35,
"high": 12.65,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 34,
"low": 28.9,
"high": 39.1,
"confidence": "low",
"value_kind": "feed",
"sold_count": 1
},
{
"company": "PSA",
"grade": "9",
"value": 8.25,
"low": 4.5,
"high": 12,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "SGC",
"grade": "10",
"value": 35.9,
"low": 30.51,
"high": 41.29,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-08-14T05:08:33.788Z",
"trend_7d": {
"direction": "flat",
"percent": 0
}
}
},
{
"id": "sv3pt5-63vrh",
"name": "Abra",
"number": "63",
"printed_number": "63",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516268",
"variants": [
{
"name": "reverseHolofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/63vrh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Basic"
],
"types": [
"Psychic"
],
"hp": "50",
"attacks": [
{
"cost": [
"Psychic"
],
"converted_energy_cost": 1,
"name": "Psyshot",
"damage": "20"
}
],
"weaknesses": [
{
"type": "Darkness",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Common",
"artist": "Mitsuhiro Arita",
"pricing": {
"currency": "USD",
"market": 0.27,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 0.27
}
],
"graded": [
{
"company": "CGC",
"grade": "10",
"value": 57.5,
"low": 48.88,
"high": 66.13,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8",
"value": 15,
"low": 12.75,
"high": 17.25,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8.5",
"value": 11,
"low": 9.35,
"high": 12.65,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9",
"value": 2.25,
"low": 2.25,
"high": 2.25,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "9.5",
"value": 19.99,
"low": 16.99,
"high": 22.99,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 139.19,
"low": 118.31,
"high": 160.07,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 6,
"low": 5.1,
"high": 6.9,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 16.05,
"low": 21,
"high": 21,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "SGC",
"grade": "10",
"value": 35.9,
"low": 30.51,
"high": 41.29,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "flat",
"percent": 0
}
}
},
{
"id": "sv3pt5-142vh",
"name": "Aerodactyl",
"number": "142",
"printed_number": "142",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516705",
"variants": [
{
"name": "holofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Stage 1"
],
"types": [
"Colorless"
],
"hp": "130",
"attacks": [
{
"cost": [
"Colorless"
],
"converted_energy_cost": 1,
"name": "Glide",
"damage": "30"
},
{
"cost": [
"Colorless",
"Colorless"
],
"converted_energy_cost": 2,
"name": "Devolution Ray",
"text": "If your opponent's Active Pokémon is an evolved Pokémon, devolve it by putting the highest Stage Evolution card on it into your opponent's hand.",
"damage": "100"
}
],
"weaknesses": [
{
"type": "Lightning",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Rare",
"artist": "Shinji Kanda",
"pricing": {
"currency": "USD",
"market": 0.39,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 0.39
},
{
"condition": "MP",
"price": 0.28
},
{
"condition": "DMG",
"price": 0.12
}
],
"graded": [
{
"company": "BGS",
"grade": "9",
"value": 7,
"low": 5.95,
"high": 8.05,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "10",
"value": 40.5,
"low": 23.5,
"high": 57.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8.5",
"value": 4,
"low": 3.4,
"high": 4.6,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9",
"value": 12,
"low": 10.2,
"high": 13.8,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9.5",
"value": 9,
"low": 7.65,
"high": 10.35,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 148.81,
"low": 153,
"high": 176.99,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "PSA",
"grade": "8",
"value": 9.54,
"low": 6.51,
"high": 6.51,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "PSA",
"grade": "9",
"value": 24.99,
"low": 17.89,
"high": 25,
"confidence": "high",
"value_kind": "sold",
"sold_count": 6
},
{
"company": "SGC",
"grade": "9.5",
"value": 8,
"low": 6.8,
"high": 9.2,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "TAG",
"grade": "10",
"value": 40,
"low": 34,
"high": 46,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "up",
"percent": 2.63
}
}
},
{
"id": "sv3pt5-142vrh",
"name": "Aerodactyl",
"number": "142",
"printed_number": "142",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516705",
"variants": [
{
"name": "reverseHolofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/142vrh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Stage 1"
],
"types": [
"Colorless"
],
"hp": "130",
"attacks": [
{
"cost": [
"Colorless"
],
"converted_energy_cost": 1,
"name": "Glide",
"damage": "30"
},
{
"cost": [
"Colorless",
"Colorless"
],
"converted_energy_cost": 2,
"name": "Devolution Ray",
"text": "If your opponent's Active Pokémon is an evolved Pokémon, devolve it by putting the highest Stage Evolution card on it into your opponent's hand.",
"damage": "100"
}
],
"weaknesses": [
{
"type": "Lightning",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Rare",
"artist": "Shinji Kanda",
"pricing": {
"currency": "USD",
"market": 1.16,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 1.16
},
{
"condition": "MP",
"price": 0.75
},
{
"condition": "DMG",
"price": 0.4
}
],
"graded": [
{
"company": "BGS",
"grade": "9",
"value": 7,
"low": 5.95,
"high": 8.05,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "10",
"value": 10.55,
"low": 9.99,
"high": 9.99,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "8.5",
"value": 4,
"low": 3.4,
"high": 4.6,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9",
"value": 12,
"low": 10.2,
"high": 13.8,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9.5",
"value": 10.25,
"low": 8.71,
"high": 11.79,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 139.25,
"low": 139.25,
"high": 187.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 6.51,
"low": 5.53,
"high": 7.49,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 23.91,
"low": 23.15,
"high": 24.33,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "SGC",
"grade": "9.5",
"value": 8,
"low": 6.8,
"high": 9.2,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "up",
"percent": 1.75
}
}
},
{
"id": "sv3pt5-188vh",
"name": "Alakazam ex",
"number": "188",
"printed_number": "188",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "517013",
"variants": [
{
"name": "holofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/188vh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Stage 2",
"ex"
],
"types": [
"Psychic"
],
"hp": "310",
"attacks": [
{
"cost": [
"Colorless",
"Colorless"
],
"converted_energy_cost": 2,
"name": "Mind Jack",
"text": "This attack does 30 more damage for each of your opponent's Benched Pokémon.",
"damage": "90"
},
{
"cost": [
"Psychic",
"Psychic"
],
"converted_energy_cost": 2,
"name": "Dimensional Hand",
"text": "This attack can be used even if this Pokémon is on the Bench.",
"damage": "120"
}
],
"weaknesses": [
{
"type": "Darkness",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Ultra Rare",
"artist": "PLANETA Tsuji",
"pricing": {
"currency": "USD",
"market": 10.53,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 10.53
},
{
"condition": "LP",
"price": 9.79
},
{
"condition": "MP",
"price": 9.01
},
{
"condition": "HP",
"price": 6.5
},
{
"condition": "DMG",
"price": 5.82
}
],
"graded": [
{
"company": "ACE",
"grade": "9",
"value": 26.32,
"low": 25.55,
"high": 26.63,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "AGS",
"grade": "10",
"value": 30,
"low": 25.5,
"high": 34.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "AGS",
"grade": "9.5",
"value": 16.25,
"low": 13.81,
"high": 18.69,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "BGS",
"grade": "9",
"value": 15.77,
"low": 13.6,
"high": 17.96,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "CGC",
"grade": "10",
"value": 41.29,
"low": 41.29,
"high": 90,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "7.5",
"value": 4,
"low": 3.4,
"high": 4.6,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8.5",
"value": 11.63,
"low": 7.5,
"high": 7.5,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "9",
"value": 13.22,
"low": 9.54,
"high": 20,
"confidence": "high",
"value_kind": "sold",
"sold_count": 5
},
{
"company": "CGC",
"grade": "9.5",
"value": 16.41,
"low": 12.5,
"high": 12.5,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "PSA",
"grade": "10",
"value": 105.14,
"low": 85.8,
"high": 127.2,
"confidence": "high",
"value_kind": "sold",
"sold_count": 28,
"trend": {
"direction": "flat",
"percent": 0
}
},
{
"company": "PSA",
"grade": "6",
"value": 13.5,
"low": 11.48,
"high": 15.52,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "7",
"value": 14.99,
"low": 16.5,
"high": 16.5,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "PSA",
"grade": "8",
"value": 15,
"low": 13.5,
"high": 18.75,
"confidence": "high",
"value_kind": "sold",
"sold_count": 6
},
{
"company": "PSA",
"grade": "8.5",
"value": 15,
"low": 12.75,
"high": 17.25,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 25.76,
"low": 21.61,
"high": 34.25,
"confidence": "high",
"value_kind": "sold",
"sold_count": 22,
"trend": {
"direction": "down",
"percent": -13.7
}
},
{
"company": "SGC",
"grade": "10",
"value": 27,
"low": 22.95,
"high": 31.05,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "SGC",
"grade": "9.5",
"value": 12,
"low": 10.2,
"high": 13.8,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "TAG",
"grade": "10",
"value": 118.43,
"low": 95.12,
"high": 129.94,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "TAG",
"grade": "9",
"value": 17.16,
"low": 12.55,
"high": 28.95,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "flat",
"percent": 0
}
}
},
{
"id": "sv3pt5-201vh",
"name": "Alakazam ex",
"number": "201",
"printed_number": "201",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "517047",
"variants": [
{
"name": "holofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/201vh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Stage 2",
"ex"
],
"types": [
"Psychic"
],
"hp": "310",
"attacks": [
{
"cost": [
"Colorless",
"Colorless"
],
"converted_energy_cost": 2,
"name": "Mind Jack",
"text": "This attack does 30 more damage for each of your opponent's Benched Pokémon.",
"damage": "90"
},
{
"cost": [
"Psychic",
"Psychic"
],
"converted_energy_cost": 2,
"name": "Dimensional Hand",
"text": "This attack can be used even if this Pokémon is on the Bench.",
"damage": "120"
}
],
"weaknesses": [
{
"type": "Darkness",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Special Illustration Rare",
"artist": "Shinya Komatsu",
"pricing": {
"currency": "USD",
"market": 72.25,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 72.25
},
{
"condition": "LP",
"price": 61.82
},
{
"condition": "MP",
"price": 58.82
},
{
"condition": "HP",
"price": 56.67
},
{
"condition": "DMG",
"price": 44.29
}
],
"graded": [
{
"company": "ACE",
"grade": "10",
"value": 192.06,
"low": 154.32,
"high": 204.59,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "ACE",
"grade": "8",
"value": 77.44,
"low": 65.82,
"high": 89.06,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "ACE",
"grade": "9",
"value": 77.86,
"low": 73.56,
"high": 89.81,
"confidence": "high",
"value_kind": "sold",
"sold_count": 6
},
{
"company": "AGS",
"grade": "10",
"value": 199.99,
"low": 169.99,
"high": 229.99,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "BGS",
"grade": "8.5",
"value": 42,
"low": 35.7,
"high": 48.3,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "BGS",
"grade": "9",
"value": 71,
"low": 70.3,
"high": 77.29,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "BGS",
"grade": "9.5",
"value": 155.44,
"low": 134.75,
"high": 192.75,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "CGC",
"grade": "10",
"value": 276.57,
"low": 137.5,
"high": 412.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "6",
"value": 69.6,
"low": 59.16,
"high": 80.04,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8",
"value": 64.49,
"low": 70,
"high": 70,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "8.5",
"value": 62.75,
"low": 53.7,
"high": 65.5,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "CGC",
"grade": "9",
"value": 71.5,
"low": 56.24,
"high": 86.09,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "CGC",
"grade": "9.5",
"value": 73,
"low": 70.6,
"high": 78.6,
"confidence": "med",
"value_kind": "sold",
"sold_count": 3
},
{
"company": "PSA",
"grade": "1",
"value": 120,
"low": 102,
"high": 138,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 325,
"low": 306.14,
"high": 398.57,
"confidence": "high",
"value_kind": "sold",
"sold_count": 143,
"trend": {
"direction": "down",
"percent": -8.5
}
},
{
"company": "PSA",
"grade": "4",
"value": 56,
"low": 47.6,
"high": 64.4,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "6",
"value": 29.5,
"low": 25.08,
"high": 33.92,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "7",
"value": 75.75,
"low": 66.33,
"high": 93.21,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "PSA",
"grade": "8",
"value": 65.35,
"low": 60.3,
"high": 79.85,
"confidence": "high",
"value_kind": "sold",
"sold_count": 34,
"trend": {
"direction": "flat",
"percent": 0
}
},
{
"company": "PSA",
"grade": "8.5",
"value": 38,
"low": 32.3,
"high": 43.7,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 82,
"low": 72,
"high": 95,
"confidence": "high",
"value_kind": "sold",
"sold_count": 163,
"trend": {
"direction": "flat",
"percent": 0
}
},
{
"company": "SGC",
"grade": "10",
"value": 159.95,
"low": 135.96,
"high": 183.94,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "SGC",
"grade": "9",
"value": 47,
"low": 39.95,
"high": 54.05,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "SGC",
"grade": "9.5",
"value": 72.55,
"low": 104.99,
"high": 104.99,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "TAG",
"grade": "10",
"value": 307,
"low": 291,
"high": 389,
"confidence": "high",
"value_kind": "sold",
"sold_count": 14,
"trend": {
"direction": "down",
"percent": -15.9
}
},
{
"company": "TAG",
"grade": "8",
"value": 64,
"low": 64,
"high": 64,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "TAG",
"grade": "8.5",
"value": 83.75,
"low": 55,
"high": 95,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "TAG",
"grade": "9",
"value": 110,
"low": 107.6,
"high": 114,
"confidence": "med",
"value_kind": "sold",
"sold_count": 3
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "flat",
"percent": -0.26
}
}
},
{
"id": "sv3pt5-65vh",
"name": "Alakazam ex",
"number": "65",
"printed_number": "65",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516381",
"variants": [
{
"name": "holofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/65vh.large.webp"
}
]
}
],
"supertype": "Pokémon",
"subtypes": [
"Stage 2",
"ex"
],
"types": [
"Psychic"
],
"hp": "310",
"attacks": [
{
"cost": [
"Colorless",
"Colorless"
],
"converted_energy_cost": 2,
"name": "Mind Jack",
"text": "This attack does 30 more damage for each of your opponent's Benched Pokémon.",
"damage": "90"
},
{
"cost": [
"Psychic",
"Psychic"
],
"converted_energy_cost": 2,
"name": "Dimensional Hand",
"text": "This attack can be used even if this Pokémon is on the Bench.",
"damage": "120"
}
],
"weaknesses": [
{
"type": "Darkness",
"value": "×2"
}
],
"resistances": [
{
"type": "Fighting",
"value": "-30"
}
],
"rarity": "Double Rare",
"artist": "Mitsuhiro Arita",
"pricing": {
"currency": "USD",
"market": 2.17,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 2.17
},
{
"condition": "LP",
"price": 1.69
},
{
"condition": "MP",
"price": 1.37
},
{
"condition": "HP",
"price": 0.71
},
{
"condition": "DMG",
"price": 1.05
}
],
"graded": [
{
"company": "ACE",
"grade": "10",
"value": 23.8,
"low": 23.8,
"high": 23.8,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "AGS",
"grade": "10",
"value": 10,
"low": 8.5,
"high": 11.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "BGS",
"grade": "8.5",
"value": 7,
"low": 5.95,
"high": 8.05,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "BGS",
"grade": "9",
"value": 30,
"low": 25.5,
"high": 34.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "10",
"value": 24.87,
"low": 17.74,
"high": 32,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "8.5",
"value": 7.5,
"low": 6.38,
"high": 8.63,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "CGC",
"grade": "9",
"value": 7.17,
"low": 7.99,
"high": 7.99,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "CGC",
"grade": "9.5",
"value": 14,
"low": 11.9,
"high": 16.1,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 117.5,
"low": 104.75,
"high": 194.3,
"confidence": "med",
"value_kind": "sold",
"sold_count": 4
},
{
"company": "PSA",
"grade": "7",
"value": 16.5,
"low": 14.03,
"high": 18.97,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 10,
"low": 9.99,
"high": 10,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
},
{
"company": "PSA",
"grade": "9",
"value": 16.3,
"low": 17.4,
"high": 17.4,
"confidence": "med",
"value_kind": "blended",
"sold_count": 1
},
{
"company": "SGC",
"grade": "10",
"value": 17.5,
"low": 14.88,
"high": 20.13,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "TAG",
"grade": "10",
"value": 20,
"low": 17,
"high": 23,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "TAG",
"grade": "8.5",
"value": 19,
"low": 16.15,
"high": 21.85,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "TAG",
"grade": "9",
"value": 10.25,
"low": 10.05,
"high": 10.45,
"confidence": "med",
"value_kind": "blended",
"sold_count": 2
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "down",
"percent": -7.26
}
}
},
{
"id": "sv3pt5-152",
"name": "Antique Dome Fossil",
"number": "152",
"printed_number": "152",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516714",
"variants": [
{
"name": "normal",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152.large.webp"
}
]
}
],
"supertype": "Trainer",
"subtypes": [
"Item"
],
"hp": "60",
"abilities": [
{
"name": "Domed Armor",
"text": "This Pokémon takes 30 less damage from attacks (after applying Weakness and Resistance).",
"type": "Ability"
}
],
"rarity": "Common",
"artist": "AYUMI ODASHIMA",
"pricing": {
"currency": "USD",
"market": 0.21,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 0.21
},
{
"condition": "MP",
"price": 0.12
}
],
"graded": [
{
"company": "CGC",
"grade": "10",
"value": 50,
"low": 42.5,
"high": 57.5,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 70,
"low": 59.5,
"high": 80.5,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 6,
"low": 5.1,
"high": 6.9,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 10.5,
"low": 8.92,
"high": 12.08,
"confidence": "low",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "flat",
"percent": 0
}
}
},
{
"id": "sv3pt5-152vrh",
"name": "Antique Dome Fossil",
"number": "152",
"printed_number": "152",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.large.webp"
}
],
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"tcgplayer_id": "516714",
"variants": [
{
"name": "reverseHolofoil",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/sv3pt5/152vrh.large.webp"
}
]
}
],
"supertype": "Trainer",
"subtypes": [
"Item"
],
"hp": "60",
"abilities": [
{
"name": "Domed Armor",
"text": "This Pokémon takes 30 less damage from attacks (after applying Weakness and Resistance).",
"type": "Ability"
}
],
"rarity": "Common",
"artist": "AYUMI ODASHIMA",
"pricing": {
"currency": "USD",
"market": 1.22,
"is_stale": false,
"conditions": [
{
"condition": "NM",
"price": 1.22
},
{
"condition": "MP",
"price": 0.55
},
{
"condition": "HP",
"price": 0.75
}
],
"graded": [
{
"company": "CGC",
"grade": "10",
"value": 50,
"low": 42.5,
"high": 57.5,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "10",
"value": 44,
"low": 37.4,
"high": 50.6,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "8",
"value": 6.75,
"low": 5.74,
"high": 7.76,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
},
{
"company": "PSA",
"grade": "9",
"value": 7.25,
"low": 6.16,
"high": 8.34,
"confidence": "med",
"value_kind": "feed",
"sold_count": 0
}
],
"market_updated_at": "2026-09-21T03:18:01.564Z",
"trend_7d": {
"direction": "up",
"percent": 7.96
}
}
}
],
"page": 1,
"page_size": 10,
"total_count": 371,
"language": "all"
}curl -X GET 'https://service.rip.fun/api/v1/pokemon/expansions/sv3pt5/cards?page_size=10&include=prices' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
q | string | — | Advanced search, e.g. `name:char*`, `(subtypes:mega OR subtypes:vmax)`, `-types:water`, `hp:[150 TO *]`, `expansion.id:sv1`; on One Piece, the gameplay fields too — `colors:Black cost:[1 TO 3] type:Character`. Capped at 512 characters, 20 terms and 5 levels of parentheses — a generated filter reaches those long before a hand-typed one does. Unknown fields return 400 with a suggestion. Full grammar + field list: see the Search & filtering guide. |
language | string | — | Language code, or a comma list. **Defaults to `en`**: every card exists once per printed language, so an unfiltered list interleaves two catalogs. Pass `language=all` for every language, or `language=ja`. The applied value comes back in the envelope. A `language:`, `id:` or `expansion.id:` term in `q` already pins the language, so the default steps aside. |
orderBy | string | — | Comma list; `-` prefix = DESC, e.g. `-release_date`. Max 3 keys. Cards sort on `name`, `number`, `rarity`, `raw_price`/`market_price`, `release_date`, `expansion.id`, `id` (plus `hp` on Pokémon and `cost`, `power`, `counter`, `life` on One Piece). Missing values sort LAST in both directions, and every sort carries a unique `id` tiebreak, so paging a sorted result set can neither skip nor repeat a row. |
distinct | string | — | Set to `code` to return one row per card rather than one per printing, and to make `total_count` count cards. Without it a page of 30 is ~17 cards and a code whose printings straddle a page boundary appears on both. The row kept is the base printing; filters that vary BETWEEN printings of a code (`rarity`, `raw_price`, `is_holo`) do not combine with it — every gameplay field does. |
page / page_size | number | — | Pagination. `page` ≥ 1 (default 1), `page_size` 1–100 (default 100, `pageSize` also accepted). Out-of-range values are rejected, never clamped. `page × page_size` capped at 10,000, so narrow with `q` to go deeper. Always compare `total_count` against the rows you received — 100 is a cap, not a promise, and a truncated page looks identical to a complete one. Collections you might assume fit in a single call do not: there are more than 100 One Piece expansions, so an unpaginated `/expansions` omits the newest sets and everything you would have walked from them. |
select | string | — | Comma list of top-level fields to keep (`id` always included). Trims response size and does not change the credit cost. |
include | string | — | Set to `prices` to embed the pricing object on every returned object. **No surcharge** — metering is a flat 1 credit per request whatever the response carries, so hydrating a page of 100 with prices costs the same as without, and strictly less than a second call per row. |
data)| Field | Description |
|---|---|
data[].id | Card id (variant printings carry a suffix, e.g. `…vh` for holofoil, `…vrh` for reverse holofoil) |
data[].name / supertype / subtypes | Card identity + classification |
data[].rarity / number / printed_number / artist | Print metadata |
data[].images[] | `{ type, small, medium, large }`, `type` always `front`. Use `small` for grids and `large` for detail views. Two caveats: `medium` is always an alias of `large` (only two sizes are stored), and on cards whose source supplied a single rendition `small` is an alias too — it points at the same file as `large`. Compare the two URLs before assuming `small` is cheap; where they differ it is roughly 6× smaller. |
data[].language / language_code | Card language: `English`/`en`, `Japanese`/`ja`, `Chinese`/`zh`. Chinese splits into Simplified (`zh-Hans`) and Traditional (`zh-Hant`). Each printing is its own object. |
data[].tcgplayer_id | TCGplayer product id for cross-referencing, or null when we don’t have one |
data[].expansion | Nested expansion object (id, name, series, total, release_date, logo, symbol, …) |
data[].variants[] | `{ name, images[] }`, one self-describing element per card printing |
data[].pricing | Present only with `include=prices` — and then always present, even where we hold nothing: `market` comes back `null` and the two arrays empty rather than the key being dropped. `{ currency, market, market_updated_at, is_stale, trend_7d, conditions[], graded[] }`, with every amount a **number** rather than a decimal string. `trend_7d` is `{ direction, percent }`, and it is the only trend window there is. See the Pricing data guide. |
data[].pricing.conditions[] | `{ condition, price }` raw ladder (NM/LP/MP/HP/DMG) for the card’s variant — those two fields only |
data[].pricing.graded[] | Reconciled graded value per company+grade: `{ company, grade, value, low, high, confidence, value_kind, sold_count, trend? }` |
| Status | Code | When |
|---|---|---|
| 400 | parse_error | malformed `q` syntax: an unclosed quote or parenthesis, a missing term, a stray operator. `details.position` is the 0-based character offset of the offending token. |
| 400 | unknown_field | a `q` term names a field this resource does not register (`subtype:` for `subtypes:`, a card field on `/sealed`), or `orderBy` names a field you cannot sort on. The message carries a did-you-mean suggestion and `details.position` points at it. Unknown fields are rejected, never ignored — an empty page would be the more expensive answer. |
| 400 | invalid_value | the field exists but the value does not fit it: a range on a field that has no ordering, a non-numeric bound, a value outside a closed vocabulary. |
| 400 | query_too_complex | `q` exceeds 512 characters, 20 terms or 5 levels of parenthesis nesting, `orderBy` names more than 3 keys, or a value breaks the wildcard guardrails (a leading `*`, more than 3 per value, fewer than 2 literal characters). Filter builders hit this before people do — count terms as you assemble, and fall back to several narrower calls rather than one wide one. |
| 400 | invalid_pagination | `page`/`page_size` non-numeric, out of range, or `page × page_size` > 10,000 |
| 400 | invalid_language | `language` is not a language code — expected `en`, `ja`, a comma list of codes, or `all` |
| 400 | invalid_distinct | `distinct` is anything other than `code` |
| 400 | invalid_select | `select` names more than 40 fields. Names that do not exist are ignored rather than rejected, so a typo silently drops the field — check the response, not just the status. |
| 400 | invalid_include | `include` carries a value this endpoint does not offer. Cards and sealed accept `prices`; the expansion endpoints accept none at all. |
| 404 | not_found | no such object for this game (a Pokémon id on `/onepiece` is "not found") |
See Errors for the response envelope and the full code list.