List series
The blocks that group sets — Base, EX, Sword & Shield, Scarlet & Violet — with the number of sets in each.
Request
- Base URL: https://api.pokemontcgapi.com
- URL: https://api.pokemontcgapi.com/v1/series
- Auth: API key in header X-Api-Key
Query parameters
set_count, name or slug, with a leading - for descending. Every order ends on slug as the tiebreaker.
Accepted snake_case spelling of orderBy; the same sort keys and cursor rules apply.
Rows per page, 1 to 250. Card and sealed lists cost 1 credit per 50 rows requested, rounded up: 50 costs 1, 51 costs 2, 250 costs 5, so ask for multiples of 50. Above 250 you get LIMIT_EXCEEDED — follow links.next instead of raising it.
Opaque keyset cursor from links.next. Never construct one; it carries the sort order it was issued for and is rejected if orderBy changes mid-run.
Headers
Send back the ETag you stored. The API returns a strong ETag on every catalogue response, and a 304 is a header exchange: no body, no database row read.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.