# Elestrals TCG API

> Public read-only API for Elestrals TCG card data.

## Docs

- [Abuse policy](https://docs.elestrals.com/abuse-policy.md): What gets a key flagged or revoked, in plain English.
- [Fetch a card by ID.](https://docs.elestrals.com/api-reference/cards/fetch-a-card-by-id.md): Returns a single card (entity) with inlined effects ordered by `order` ascending and the nested creature ref. Use `/v1/cards/{id}/printings` (shipping in a later release) to enumerate physical printings.
- [List cards with rich filtering.](https://docs.elestrals.com/api-reference/cards/list-cards-with-rich-filtering.md): Cursor-paginated list of game entities. The public "card" resource is the Entity (game piece); physical printings live under `/v1/printings`. Default sort is `name` ascending. Nullable stats (`attack`, `defense`) use a sentinel for deterministic cursor ordering.
- [List printings for a single card.](https://docs.elestrals.com/api-reference/cards/list-printings-for-a-single-card.md)
- [Fetch a creature by ID.](https://docs.elestrals.com/api-reference/creatures/fetch-a-creature-by-id.md)
- [List cards that share a creature.](https://docs.elestrals.com/api-reference/creatures/list-cards-that-share-a-creature.md): Returns a paginated list of cards (entities) whose `creature_id` matches the given creature. Accepts all the same filters and sorts as `GET /v1/cards` except for `set_id`, which remains available.
- [List creatures.](https://docs.elestrals.com/api-reference/creatures/list-creatures.md): Cursor-paginated list of creatures. Default sort is `name` ascending.
- [Liveness probe.](https://docs.elestrals.com/api-reference/meta/liveness-probe.md): Returns 200 with a minimal status payload. Useful for uptime checks.
- [Fetch a printing by ID.](https://docs.elestrals.com/api-reference/printings/fetch-a-printing-by-id.md)
- [List physical printings.](https://docs.elestrals.com/api-reference/printings/list-physical-printings.md): Cursor-paginated list of physical printings (one row per `Card`). Only printings whose set is publicly displayed are returned.
- [Fetch a series by ID.](https://docs.elestrals.com/api-reference/series/fetch-a-series-by-id.md)
- [List all series.](https://docs.elestrals.com/api-reference/series/list-all-series.md): Returns every series ordered by `sort_order` ascending. Only six series exist today; pagination fields are always `next_cursor: null, has_more: false`.
- [Fetch a set by ID or abbreviation.](https://docs.elestrals.com/api-reference/sets/fetch-a-set-by-id-or-abbreviation.md): Accepts the canonical ID (`st-...`) or the set abbreviation (e.g. `BS1`, `SD01`). Abbreviations are expected to be unique; the Worker returns 500 if more than one set shares an abbreviation (data integrity issue).
- [List printings for a single set.](https://docs.elestrals.com/api-reference/sets/list-printings-for-a-single-set.md)
- [List public sets.](https://docs.elestrals.com/api-reference/sets/list-public-sets.md): Cursor-paginated list of sets. Only sets flagged as publicly displayed are returned. Default sort is `release_date` descending, nulls last.
- [Attribution](https://docs.elestrals.com/attribution.md): How and where to credit Elestrals when you use the API.
- [Authentication](https://docs.elestrals.com/authentication.md): How to authenticate every request and rotate keys safely.
- [Banlists & formats](https://docs.elestrals.com/banlists-and-formats.md): How card legality is encoded across organized-play formats.
- [Caching](https://docs.elestrals.com/caching.md): Edge cache TTLs, how to read cache state, and how to cache on your end.
- [Enums](https://docs.elestrals.com/enums.md): Every closed-set field value, with a one-line gloss for each.
- [Errors](https://docs.elestrals.com/errors.md): One envelope shape, a closed set of codes, a docs URL on every failure.
- [Identifiers](https://docs.elestrals.com/identifiers.md): Every ID prefix in the API and what it points at.
- [Images](https://docs.elestrals.com/images.md): Thumbnails only, 512px max, served from a CDN that you should not hotlink.
- [Introduction](https://docs.elestrals.com/introduction.md): A read-only HTTP API for Elestrals TCG card data.
- [Monitor your usage](https://docs.elestrals.com/monitor-your-usage.md): Where to find your request volume, error rate, and remaining quota.
- [Pagination](https://docs.elestrals.com/pagination.md): Cursor-based pagination on every list endpoint.
- [Quickstart](https://docs.elestrals.com/quickstart.md): Mint a key, make your first request, parse the response.
- [Rate limits](https://docs.elestrals.com/rate-limits.md): Two budgets — per-minute burst and monthly quota — both enforced at the edge.
- [Resource model](https://docs.elestrals.com/resource-model.md): How Series, Sets, Printings, Cards, and Creatures relate to one another.
- [Rulings](https://docs.elestrals.com/rulings.md): Official clarifications on how a Card behaves, attached to that Card's record.

## OpenAPI Specs

- [openapi](https://docs.elestrals.com/openapi.yaml)