Search cards

GET /api/v1/:tcg/cards read:catalog

Search all cards for a game (`pokemon` or `onepiece`). Filter with the advanced `q` search string, sort with `orderBy`, page with `page`/`page_size`, and opt into pricing with `include=prices`. Wrapped in `{ success, data, page, page_size, total_count }`.

Try it GET /api/v1/pokemon/cards?include=prices&page_size=10

These inputs are shared across all docs pages — an id entered here carries over.

response
200 617ms preloaded server-side with the default context
object · 5 keys
{
  "success": true,
  "data": [
    {
      "id": "pl2-88",
      "name": "Aaron's Collection",
      "number": "88",
      "printed_number": "88",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.large.png"
        }
      ],
      "expansion": {
        "id": "pl2",
        "name": "Rising Rivals",
        "total": 120,
        "language": "English",
        "language_code": "en",
        "series": "Platinum",
        "code": "RR",
        "printed_total": 111,
        "release_date": "2009/05/16",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/pl2.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/pl2.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83439",
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88.large.png"
            }
          ]
        }
      ],
      "supertype": "Trainer",
      "subtypes": [
        "Supporter"
      ],
      "rarity": "Uncommon",
      "artist": "Ken Sugimori",
      "pricing": {
        "currency": "USD",
        "market": 0.54,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 0.54
          },
          {
            "condition": "LP",
            "price": 0.42
          },
          {
            "condition": "MP",
            "price": 0.37
          },
          {
            "condition": "HP",
            "price": 0.29
          },
          {
            "condition": "DMG",
            "price": 0.32
          }
        ],
        "graded": [],
        "market_updated_at": "2026-07-28T17:36:28.145Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    },
    {
      "id": "pl2-88vrh",
      "name": "Aaron's Collection",
      "number": "88",
      "printed_number": "88",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.large.png"
        }
      ],
      "expansion": {
        "id": "pl2",
        "name": "Rising Rivals",
        "total": 120,
        "language": "English",
        "language_code": "en",
        "series": "Platinum",
        "code": "RR",
        "printed_total": 111,
        "release_date": "2009/05/16",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/pl2.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/pl2.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83439",
      "variants": [
        {
          "name": "reverseHolofoil",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/pl2/88vrh.large.png"
            }
          ]
        }
      ],
      "supertype": "Trainer",
      "subtypes": [
        "Supporter"
      ],
      "rarity": "Uncommon",
      "artist": "Ken Sugimori",
      "pricing": {
        "currency": "USD",
        "market": 0.1,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 0.1
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "6",
            "value": 31.95,
            "low": 27.16,
            "high": 36.74,
            "confidence": "med",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-28T17:36:28.145Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    },
    {
      "id": "smp_ja-320",
      "name": "Abareru-kun",
      "number": "320",
      "printed_number": "320",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.large.png"
        }
      ],
      "expansion": {
        "id": "smp_ja",
        "name": "Sun & Moon Promos",
        "total": 409,
        "language": "Japanese",
        "language_code": "ja",
        "series": "Sun & Moon",
        "printed_total": 409,
        "release_date": "2016/11/01",
        "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/smp_ja.logo.png",
        "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/smp_ja.symbol.png",
        "translation": {
          "en": {
            "name": "Sun & Moon Promos"
          }
        }
      },
      "language": "Japanese",
      "language_code": "ja",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/smp_ja/320.large.png"
            }
          ]
        }
      ],
      "supertype": "Trainer",
      "subtypes": [
        "Supporter"
      ],
      "rarity": "Promo",
      "artist": "HYOGONOSUKE",
      "pricing": {
        "currency": "USD",
        "market": 183,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 183
          }
        ],
        "graded": [
          {
            "company": "ACE",
            "grade": "10",
            "value": 131.58,
            "low": 111.84,
            "high": 151.32,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "10",
            "value": 749.99,
            "low": 407.5,
            "high": 749.99,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "4",
            "value": 76,
            "low": 64.6,
            "high": 87.4,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "7",
            "value": 117,
            "low": 99.45,
            "high": 134.55,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "8",
            "value": 173.34,
            "low": 147.34,
            "high": 199.34,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "9",
            "value": 104.5,
            "low": 104.5,
            "high": 250.5,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 1
          }
        ],
        "market_updated_at": "2026-07-29T15:18:52.081Z",
        "trend_7d": {
          "direction": "flat",
          "percent": -0.49
        }
      }
    },
    {
      "id": "bw10-26",
      "name": "Abomasnow",
      "number": "26",
      "printed_number": "26",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.large.png"
        }
      ],
      "expansion": {
        "id": "bw10",
        "name": "Plasma Blast",
        "total": 105,
        "language": "English",
        "language_code": "en",
        "series": "Black & White",
        "code": "PLB",
        "printed_total": 101,
        "release_date": "2013/08/14",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/bw10.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/bw10.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83442",
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Water"
      ],
      "hp": "120",
      "attacks": [
        {
          "cost": [
            "Grass",
            "Grass"
          ],
          "converted_energy_cost": 2,
          "name": "Razor Leaf",
          "damage": "40"
        },
        {
          "cost": [
            "Grass",
            "Grass",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Bang Heads",
          "text": "Both this Pokémon and the Defending Pokémon are now Confused.",
          "damage": "80"
        }
      ],
      "weaknesses": [
        {
          "type": "Metal",
          "value": "×2"
        }
      ],
      "rarity": "Uncommon",
      "artist": "kawayoo",
      "pricing": {
        "currency": "USD",
        "market": 0.29,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 0.29
          },
          {
            "condition": "LP",
            "price": 0.24
          },
          {
            "condition": "MP",
            "price": 0.14
          },
          {
            "condition": "HP",
            "price": 0.12
          },
          {
            "condition": "DMG",
            "price": 0.25
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "9",
            "value": 26,
            "low": 22.1,
            "high": 29.9,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-29T12:07:11.880Z",
        "trend_7d": {
          "direction": "up",
          "percent": 3.57
        }
      }
    },
    {
      "id": "bw10-26vrh",
      "name": "Abomasnow",
      "number": "26",
      "printed_number": "26",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.large.png"
        }
      ],
      "expansion": {
        "id": "bw10",
        "name": "Plasma Blast",
        "total": 105,
        "language": "English",
        "language_code": "en",
        "series": "Black & White",
        "code": "PLB",
        "printed_total": 101,
        "release_date": "2013/08/14",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/bw10.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/bw10.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83442",
      "variants": [
        {
          "name": "reverseHolofoil",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw10/26vrh.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Water"
      ],
      "hp": "120",
      "attacks": [
        {
          "cost": [
            "Grass",
            "Grass"
          ],
          "converted_energy_cost": 2,
          "name": "Razor Leaf",
          "damage": "40"
        },
        {
          "cost": [
            "Grass",
            "Grass",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Bang Heads",
          "text": "Both this Pokémon and the Defending Pokémon are now Confused.",
          "damage": "80"
        }
      ],
      "weaknesses": [
        {
          "type": "Metal",
          "value": "×2"
        }
      ],
      "rarity": "Uncommon",
      "artist": "kawayoo",
      "pricing": {
        "currency": "USD",
        "market": 0.86,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 0.86
          },
          {
            "condition": "LP",
            "price": 0.57
          },
          {
            "condition": "HP",
            "price": 0.22
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "9",
            "value": 26,
            "low": 22.1,
            "high": 29.9,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-29T12:07:11.880Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    },
    {
      "id": "bw9_ja-20",
      "name": "Abomasnow",
      "number": "20",
      "printed_number": "20",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.large.png"
        }
      ],
      "expansion": {
        "id": "bw9_ja",
        "name": "Megalo Cannon",
        "total": 86,
        "language": "Japanese",
        "language_code": "ja",
        "series": "Black & White",
        "code": "BW9",
        "printed_total": 76,
        "release_date": "2013/03/15",
        "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/bw9_ja.logo.png",
        "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/bw9_ja.symbol.png",
        "translation": {
          "en": {
            "name": "Megalo Cannon"
          }
        }
      },
      "language": "Japanese",
      "language_code": "ja",
      "tcgplayer_id": "602702",
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/bw9_ja/20.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Water"
      ],
      "attacks": [
        {
          "cost": [
            "Grass",
            "Grass"
          ],
          "converted_energy_cost": 2,
          "name": "Razor Leaf"
        },
        {
          "cost": [
            "Grass",
            "Grass",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Bang Heads",
          "text": "Both this Pokémon and the Defending Pokémon are now Confused."
        }
      ],
      "rarity": "usually",
      "artist": "kawayoo",
      "pricing": {
        "currency": "USD",
        "market": 6,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 6
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "10",
            "value": 30,
            "low": 25.5,
            "high": 34.5,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-16T02:24:58.332Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    },
    {
      "id": "dp2-19",
      "name": "Abomasnow",
      "number": "19",
      "printed_number": "19",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.large.png"
        }
      ],
      "expansion": {
        "id": "dp2",
        "name": "Mysterious Treasures",
        "total": 124,
        "language": "English",
        "language_code": "en",
        "series": "Diamond & Pearl",
        "code": "MT",
        "printed_total": 123,
        "release_date": "2007/08/01",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/dp2.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/dp2.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83440",
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Grass"
      ],
      "hp": "100",
      "abilities": [
        {
          "name": "Glacier Snow",
          "text": "If Abomasnow is your Active Pokémon and is damaged by an opponent's attack (even if Abomasnow is Knocked Out), the Attacking Pokémon is now Asleep.",
          "type": "Poké-Body"
        }
      ],
      "attacks": [
        {
          "cost": [
            "Water",
            "Colorless",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Heavy Blizzard",
          "text": "Flip a coin. If heads, put 1 damage counter on each of your opponent's Benched Pokémon.",
          "damage": "60"
        }
      ],
      "weaknesses": [
        {
          "type": "Fire",
          "value": "+30"
        }
      ],
      "rarity": "Rare",
      "artist": "Kazuyuki Kano",
      "pricing": {
        "currency": "USD",
        "market": 0.73,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 0.73
          },
          {
            "condition": "MP",
            "price": 0.49
          },
          {
            "condition": "HP",
            "price": 0.29
          },
          {
            "condition": "DMG",
            "price": 0.42
          }
        ],
        "graded": [
          {
            "company": "CGC",
            "grade": "8",
            "value": 8,
            "low": 6.8,
            "high": 9.2,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "CGC",
            "grade": "8.5",
            "value": 9.5,
            "low": 8.07,
            "high": 10.93,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "CGC",
            "grade": "9",
            "value": 3,
            "low": 2.55,
            "high": 3.45,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "8",
            "value": 65,
            "low": 55.25,
            "high": 74.75,
            "confidence": "med",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-29T10:36:42.944Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    },
    {
      "id": "dp2-19vrh",
      "name": "Abomasnow",
      "number": "19",
      "printed_number": "19",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.large.png"
        }
      ],
      "expansion": {
        "id": "dp2",
        "name": "Mysterious Treasures",
        "total": 124,
        "language": "English",
        "language_code": "en",
        "series": "Diamond & Pearl",
        "code": "MT",
        "printed_total": 123,
        "release_date": "2007/08/01",
        "logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/dp2.logo.png",
        "symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/dp2.symbol.png"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": "83440",
      "variants": [
        {
          "name": "reverseHolofoil",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2/19vrh.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Grass"
      ],
      "hp": "100",
      "abilities": [
        {
          "name": "Glacier Snow",
          "text": "If Abomasnow is your Active Pokémon and is damaged by an opponent's attack (even if Abomasnow is Knocked Out), the Attacking Pokémon is now Asleep.",
          "type": "Poké-Body"
        }
      ],
      "attacks": [
        {
          "cost": [
            "Water",
            "Colorless",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Heavy Blizzard",
          "text": "Flip a coin. If heads, put 1 damage counter on each of your opponent's Benched Pokémon.",
          "damage": "60"
        }
      ],
      "weaknesses": [
        {
          "type": "Fire",
          "value": "+30"
        }
      ],
      "rarity": "Rare",
      "artist": "Kazuyuki Kano",
      "pricing": {
        "currency": "USD",
        "market": 3.5,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 3.5
          },
          {
            "condition": "LP",
            "price": 1.37
          },
          {
            "condition": "MP",
            "price": 0.8
          },
          {
            "condition": "HP",
            "price": 0.58
          },
          {
            "condition": "DMG",
            "price": 0.66
          }
        ],
        "graded": [
          {
            "company": "CGC",
            "grade": "8",
            "value": 8,
            "low": 6.8,
            "high": 9.2,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "CGC",
            "grade": "8.5",
            "value": 9.5,
            "low": 8.07,
            "high": 10.93,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "CGC",
            "grade": "9",
            "value": 9,
            "low": 7.65,
            "high": 10.35,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          },
          {
            "company": "PSA",
            "grade": "8",
            "value": 65,
            "low": 55.25,
            "high": 74.75,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-29T10:36:42.944Z",
        "trend_7d": {
          "direction": "flat",
          "percent": -0.28
        }
      }
    },
    {
      "id": "dp2_ja-517",
      "name": "Abomasnow",
      "number": "517",
      "printed_number": "517",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.large.png"
        }
      ],
      "expansion": {
        "id": "dp2_ja",
        "name": "Secret of the Lakes",
        "total": 123,
        "language": "Japanese",
        "language_code": "ja",
        "series": "Diamond & Pearl",
        "code": "DP2",
        "printed_total": 123,
        "release_date": "2007/03/02",
        "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/dp2_ja.logo.png",
        "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/dp2_ja.symbol.png",
        "translation": {
          "en": {
            "name": "Secret of the Lakes"
          }
        }
      },
      "language": "Japanese",
      "language_code": "ja",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp2_ja-517.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Grass"
      ],
      "abilities": [
        {
          "name": "Glacier Snow",
          "text": "If Abomasnow is your Active Pokémon and is damaged by an opponent's attack (even if Abomasnow is Knocked Out), the Attacking Pokémon is now Asleep.",
          "type": "Poké-Body"
        }
      ],
      "attacks": [
        {
          "cost": [
            "Water",
            "Colorless",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Heavy Blizzard",
          "text": "Flip a coin. If heads, put 1 damage counter on each of your opponent's Benched Pokémon."
        }
      ],
      "rarity": "Rare",
      "artist": "Kazuyuki Kano",
      "pricing": {
        "currency": "USD",
        "market": 2.84,
        "is_stale": true,
        "conditions": [
          {
            "condition": "NM",
            "price": 2.84
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "10",
            "value": 46,
            "low": 39.1,
            "high": 52.9,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-29T17:16:24.828Z",
        "trend_7d": {
          "direction": "down",
          "percent": -23.04
        }
      }
    },
    {
      "id": "dp6_ja-22",
      "name": "Abomasnow",
      "number": "22",
      "printed_number": "22",
      "images": [
        {
          "type": "front",
          "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.small.png",
          "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.large.png",
          "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.large.png"
        }
      ],
      "expansion": {
        "id": "dp6_ja",
        "name": "Intense Fight in the Destroyed Sky",
        "total": 92,
        "language": "Japanese",
        "language_code": "ja",
        "series": "Diamond & Pearl",
        "code": "DP6",
        "printed_total": 92,
        "release_date": "2008/07/10",
        "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/dp6_ja.logo.png",
        "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/dp6_ja.symbol.png",
        "translation": {
          "en": {
            "name": "Intense Fight in the Destroyed Sky"
          }
        }
      },
      "language": "Japanese",
      "language_code": "ja",
      "tcgplayer_id": "608108",
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.small.png",
              "medium": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.large.png",
              "large": "https://api.rip.fun/storage/v1/object/public/tcg/cards/dp6_ja/22.large.png"
            }
          ]
        }
      ],
      "supertype": "Pokémon",
      "subtypes": [
        "Stage 1"
      ],
      "types": [
        "Water"
      ],
      "abilities": [
        {
          "name": "Snow Veil",
          "text": "As long as Abomasnow is your Active Pokémon, any damage done to your Pokémon by an opponent's attack is reduced by 20 (after applying Weakness and Resistance).",
          "type": "Poké-Body"
        }
      ],
      "attacks": [
        {
          "cost": [
            "Colorless",
            "Colorless"
          ],
          "converted_energy_cost": 2,
          "name": "Snow Play",
          "text": "Does 20 damage to each of your opponent's Benched Pokémon, excluding Grass Pokémon and Water Pokémon. (Don't apply Weakness and Resistance for Benched Pokémon.)"
        },
        {
          "cost": [
            "Water",
            "Colorless",
            "Colorless"
          ],
          "converted_energy_cost": 3,
          "name": "Below Zero",
          "text": "If Abomasnow evolved from Snover during this turn, the Defending Pokémon is now Paralyzed."
        }
      ],
      "rarity": "Rare",
      "artist": "Mitsuhiro Arita",
      "pricing": {
        "currency": "USD",
        "market": 5,
        "is_stale": false,
        "conditions": [
          {
            "condition": "NM",
            "price": 5
          }
        ],
        "graded": [
          {
            "company": "PSA",
            "grade": "10",
            "value": 53.82,
            "low": 45.75,
            "high": 61.89,
            "confidence": "low",
            "value_kind": "feed",
            "sold_count": 0
          }
        ],
        "market_updated_at": "2026-07-16T02:35:59.194Z",
        "trend_7d": {
          "direction": "flat",
          "percent": 0
        }
      }
    }
  ],
  "page": 1,
  "page_size": 10,
  "total_count": 64058
}
curl (tracks the inputs above)
curl -X GET 'https://service.rip.fun/api/v1/pokemon/cards?include=prices&page_size=10' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
qstringAdvanced search, e.g. `name:char*`, `(subtypes:mega OR subtypes:vmax)`, `-types:water`, `hp:[150 TO *]`, `expansion.id:sv1`. Unknown fields return 400 with a suggestion. Full grammar + field list: see the Search & filtering guide.
orderBystringComma list; `-` prefix = DESC, e.g. `-release_date`. Max 3 keys.
page / page_sizenumberPagination. `page` ≥ 1 (default 1), `page_size` 1–100 (default 100). `page × page_size` capped at 10,000.
selectstringComma list of top-level fields to keep (`id` always included).

Response fields (data)

FieldDescription
data[].idCard id (variant printings carry a suffix, e.g. `…vh` for holofoil, `…vrh` for reverse holofoil)
data[].name / supertype / subtypes / typesCard identity + classification (One Piece cards expose `type` / `cost` / `power` / `attribute` / `colors` instead of `types`/`hp`)
data[].rarity / number / printed_number / artistPrint metadata
data[].hp / attacks / weaknesses / resistances / abilitiesPokémon game data (omitted when not applicable)
data[].images[]`{ type, small, medium, large }` — `medium` is aliased to `large` (only two sizes stored)
data[].language / language_codeCard language — `English`/`en`, `Japanese`/`ja`, `Chinese`/`zh` (Simplified `zh-Hans`, Traditional `zh-Hant`)
data[].tcgplayer_idTCGplayer product id for cross-referencing, or null when we don’t have one
data[].expansionNested expansion object (id, name, series, total, release_date, logo, symbol, …)
data[].variants[]`{ name, images[] }` — one self-describing element per card printing
data[].pricingPresent only with `include=prices`. Our own dedicated pricing: `{ currency, market, market_updated_at, is_stale, trend_7d, conditions[], graded[] }`. See the Pricing guide.
data[].pricing.conditions[]`{ condition, price }` raw ladder (NM/LP/MP/HP/DMG) for the card’s variant
data[].pricing.graded[]Reconciled graded value per company+grade: `{ company, grade, value, low, high, confidence, value_kind, sold_count, trend? }`. The dedicated /prices endpoint adds `band` + `last_sold_at`.

Errors

StatusCodeWhen
400invalid_querymalformed `q` — bad syntax, unknown field, or a disallowed pattern (leading wildcard, too complex). Response `details.position` points at the offending character.
400invalid_pagination`page`/`page_size` non-numeric, out of range, or `page × page_size` > 10,000
404not_foundno such card/expansion for this game (a Pokémon id on `/onepiece` is "not found")

See Errors for the response envelope and the full code list.