---
title: "GET /sets — JustTCG API"
description: "GET /sets lists every card set, optionally filtered by game, returning each set's id, name, release date, and total set value in USD."
url: https://justtcg.com/docs/api/sets
markdown_url: https://justtcg.com/docs/api/sets.md
---

# /sets

List every set, optionally filtered by game.

`GET https://api.justtcg.com/v1/sets`

## Parameters

**`game`** · string · Optional

Restrict results to a single game ID (e.g. `pokemon`). Optional.

**`q`** · string · Optional

Search by set name

## Response

**`data[].id`** · string · Required

Stable set ID, lowercase-hyphenated, includes the game name to avoid collisions.

**`data[].name`** · string · Required

Human-readable set name.

**`data[].game`** · string · Required

The game this set belongs to.

**`data[].release_date`** · string (ISO 8601) · Optional

The set's release date.

**`data[].set_value_usd`** · number · Optional

Total estimated value of every card in the set.

**`data[].variants_count`** · integer · Optional

Number of distinct variants tracked in the set.

**`data[].sealed_count`** · integer · Optional

Number of sealed products tracked for this set.

```typescript
import { JustTCG } from 'justtcg-js';

const client = new JustTCG();
const { data } = await client.v1.sets.list({ game: 'pokemon' });
```

```json
{
  "data": [
    { "id": "battle-academy-pokemon", "name": "Battle Academy", "game": "pokemon" }
  ]
}
```