Search expansions

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

List every expansion (set) for a game, or filter with `q` (e.g. `series_id:sv`, `release_date:[2024-01-01 TO *]`) and sort with `orderBy`. Wrapped in `{ success, data, page, page_size, total_count }`.

Try it GET /api/v1/pokemon/expansions?page_size=10

Game q (search) orderBy

Limit

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

response

200 256ms preloaded server-side with the default context

object · 5 keys

{
  "success": true,
  "data": [
    {
      "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"
    },
    {
      "id": "swsh8a_ja",
      "name": "25th Anniversary Collection",
      "total": 38,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Sword & Shield",
      "code": "S8a",
      "printed_total": 28,
      "release_date": "2021/10/22",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh8a_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh8a_ja.symbol.png",
      "translation": {
        "en": {
          "name": "25th Anniversary Collection"
        }
      }
    },
    {
      "id": "swsh8a_zh",
      "name": "25th Anniversary Collection (Chinese)",
      "total": 38,
      "language": "Chinese",
      "language_code": "zh",
      "series": "Sword & Shield",
      "code": "S8a",
      "printed_total": 28,
      "release_date": "2021/10/22",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh8a_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh8a_ja.symbol.png",
      "translation": {
        "en": {
          "name": "25th Anniversary Collection (Chinese)"
        }
      }
    },
    {
      "id": "m5_ja",
      "name": "Abyss Eye",
      "total": 118,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Mega Evolution",
      "code": "M5",
      "printed_total": 81,
      "release_date": "2026/05/22",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/m5_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/m5_ja.symbol.png",
      "translation": {
        "en": {
          "name": "Abyss Eye"
        }
      }
    },
    {
      "id": "pt4_ja",
      "name": "Advent of Arceus",
      "total": 90,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Platinum",
      "code": "PT4",
      "printed_total": 90,
      "release_date": "2009/07/08",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/pt4_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/pt4_ja.symbol.png",
      "translation": {
        "en": {
          "name": "Advent of Arceus"
        }
      }
    },
    {
      "id": "adv1_ja",
      "name": "ADV Expansion Pack",
      "total": 55,
      "language": "Japanese",
      "language_code": "ja",
      "series": "ADV",
      "printed_total": 55,
      "release_date": "2003/01/31",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/adv1_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/adv1_ja.symbol.png",
      "translation": {
        "en": {
          "name": "ADV Expansion Pack"
        }
      }
    },
    {
      "id": "advp_ja",
      "name": "ADV Promos",
      "total": 63,
      "language": "Japanese",
      "language_code": "ja",
      "series": "ADV",
      "printed_total": 63,
      "release_date": "2003/01/01",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/advp_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/advp_ja.symbol.png",
      "translation": {
        "en": {
          "name": "ADV Promos"
        }
      }
    },
    {
      "id": "sm2l_ja",
      "name": "Alolan Moonlight",
      "total": 55,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Sun & Moon",
      "code": "SM2L",
      "printed_total": 50,
      "release_date": "2017/03/17",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/sm2l_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/sm2l_ja.symbol.png",
      "translation": {
        "en": {
          "name": "Alolan Moonlight"
        }
      }
    },
    {
      "id": "sm12_ja",
      "name": "Alter Genesis",
      "total": 117,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Sun & Moon",
      "code": "SM12",
      "printed_total": 95,
      "release_date": "2019/09/06",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/sm12_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/sm12_ja.symbol.png",
      "translation": {
        "en": {
          "name": "Alter Genesis"
        }
      }
    },
    {
      "id": "swsh4_ja",
      "name": "Amazing Volt Tackle",
      "total": 121,
      "language": "Japanese",
      "language_code": "ja",
      "series": "Sword & Shield",
      "code": "S4",
      "printed_total": 100,
      "release_date": "2020/09/18",
      "logo": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh4_ja.logo.png",
      "symbol": "https://api.rip.fun/storage/v1/object/public/tcg/sets/swsh4_ja.symbol.png",
      "translation": {
        "en": {
          "name": "Amazing Volt Tackle"
        }
      }
    }
  ],
  "page": 1,
  "page_size": 10,
  "total_count": 463
}

curl (tracks the inputs above)

curl -X GET 'https://service.rip.fun/api/v1/pokemon/expansions?page_size=10' \
  -H 'X-API-Key: rip_…'

Request fields

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`. Unknown fields return 400 with a suggestion. Full grammar + field list: see the Search & filtering guide.
`orderBy`	string	—	Comma list; `-` prefix = DESC, e.g. `-release_date`. Max 3 keys.
`page / page_size`	number	—	Pagination. `page` ≥ 1 (default 1), `page_size` 1–100 (default 100). `page × page_size` capped at 10,000.
`select`	string	—	Comma list of top-level fields to keep (`id` always included).

Response fields (`data`)

Field	Description
`data[].id / name / series / code`	Expansion identity
`data[].total / printed_total`	Card counts (incl. secret rares vs printed)
`data[].language / language_code`	Canonicalized language + ISO code
`data[].release_date`	Release date, `YYYY/MM/DD`
`data[].logo / symbol`	Artwork URLs
`data[].translation`	English name under `translation.en.name` for non-English sets

Errors

Status	Code	When
400	`invalid_query`	malformed `q` — bad syntax, unknown field, or a disallowed pattern (leading wildcard, too complex). Response `details.position` points at the offending character.
400	`invalid_pagination`	`page`/`page_size` non-numeric, out of range, or `page × page_size` > 10,000
404	`not_found`	no 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.

Search expansions

Request fields

Response fields (data)

Errors

Response fields (`data`)