Sets

Sets (also called expansions or collections) group cards within a game.

List Sets

GET /v1/sets

Authentication: API key required

Query Parameters:

Parameter	Type	Description
`game`	string	Filter by game slug (e.g., `pokemon`)
`page`	integer	Page number (default: 1)
`per_page`	integer	Results per page (default: 50, max: 100)

Example:

curl "https://api.tcgapi.dev/v1/sets?game=pokemon" \
  -H "X-API-Key: YOUR_KEY"

Get Set by ID

GET /v1/sets/:id

Authentication: API key required

Example:

curl "https://api.tcgapi.dev/v1/sets/1234" \
  -H "X-API-Key: YOUR_KEY"

Response:

{
  "data": {
    "id": 1234,
    "game_id": 55,
    "name": "Obsidian Flames",
    "slug": "obsidian-flames",
    "abbreviation": "OBF",
    "release_date": "2023-08-11",
    "card_count": 230,
    "last_synced_at": "2026-02-19T02:15:00.000Z",
    "game_name": "Pokemon",
    "game_slug": "pokemon"
  }
}

Get Cards in a Set

GET /v1/sets/:id/cards

Authentication: API key required

Query Parameters:

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`per_page`	integer	Results per page (default: 50, max: 100)

Example:

curl "https://api.tcgapi.dev/v1/sets/1234/cards" \
  -H "X-API-Key: YOUR_KEY"

Get Set Prices

GET /v1/sets/:id/prices

Authentication: API key required (Pro tier)

Returns all card prices in a set — useful for building set value trackers.

Example:

curl "https://api.tcgapi.dev/v1/sets/1234/prices" \
  -H "X-API-Key: YOUR_PRO_KEY"