Get an expansion

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

Fetch one expansion by its id. An expansion id from the other game returns 404. Wrapped in `{ success, data }`.

Try it GET /api/v1/pokemon/expansions/sv3pt5

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

response
200 38ms preloaded server-side with the default context
object · 2 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"
  }
}
curl (tracks the inputs above)
curl -X GET 'https://service.rip.fun/api/v1/pokemon/expansions/sv3pt5' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
expansion_idstringyesPath param — the expansion id, e.g. `sv3pt5`.
selectstringComma list of top-level fields to keep.

Response fields (data)

FieldDescription
data[].id / name / series / codeExpansion identity
data[].total / printed_totalCard counts (incl. secret rares vs printed)
data[].language / language_codeCanonicalized language + ISO code
data[].release_dateRelease date, `YYYY/MM/DD`
data[].logo / symbolArtwork URLs
data[].translationEnglish name under `translation.en.name` for non-English sets

Errors

StatusCodeWhen
404not_foundno expansion with that id for this game

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