---
title: "Browse Japanese sets"
method: GET
path: "/v1/catalog/sets"
tags: ["Japanese catalogue"]
---

# Browse Japanese sets

`GET /v1/catalog/sets`

## Request

- Base URL: `https://tcgdata-api.ottenniels1999.workers.dev`
- URL: `https://tcgdata-api.ottenniels1999.workers.dev/v1/catalog/sets`
- Auth: HTTP bearer

Deduplicated source sets with card_count. Counts describe catalogue records and memberships, not unique physical printings.

1 admitted HTTP request. Unknown query/body parameters are rejected. Examples contain illustrative data and placeholder IDs; they are not live catalogue records.

## Query parameters

- `game` 'pokemon_jp', required
- `q` string
- `limit` integer
- `after` string
- `release_status` 'released' | 'unreleased' | 'unknown' | 'all'

## Response `200`

Success. 1 admitted HTTP request.

- CatalogueSetList
  - `data` CatalogueSet[], required
    - `id` string, required
    - `name` string, nullable, required
    - `game` 'pokemon_jp', required
    - `card_count` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid request or batch_size_exceeded (more IDs than the account plan allows)
- `401`: Invalid or missing key
- `403`: Inactive account, expired free test or resource_limits_unconfigured
- `404`: Not found or unavailable
- `405`: Wrong method
- `409`: Ambiguous printing or variant
- `413`: Oversized request body or response_too_large (response exceeds 1 MiB)
- `415`: Wrong content type
- `429`: Monthly, UTC-daily or minute request limit; authenticated account limits include a paid-plan or custom-access upgrade suggestion. Defensive resource-limit errors retain the ordinary error envelope.
- `503`: Disabled, unconfigured or temporarily unavailable

---

[API](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history.md) · [All operations](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history/llms.txt) · [OpenAPI document](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history/revisions/1db91fd8a408?raw)