> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elestrals.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> A read-only HTTP API for Elestrals TCG card data.

The Elestrals TCG API exposes the full card catalog — series, sets, creatures, cards, and printings — as a stable, versioned REST API. It's the same data that powers `elestrals.com`, packaged for community tool builders, content creators, and partner apps.

## What you get

<CardGroup cols={2}>
  <Card title="Stable resources" icon="database">
    Cards, sets, series, creatures, and printings — exposed as DTOs decoupled from the internal
    schema, so refactors don't break you.
  </Card>

  <Card title="Versioned from day one" icon="tag">
    Every endpoint lives under `/v1/`. Breaking changes become `/v2/` with at least six months'
    notice on the old version.
  </Card>

  <Card title="Edge-cached" icon="bolt">
    Responses are served from Cloudflare's edge. Most reads are sub-50ms.
  </Card>

  <Card title="Read-only" icon="lock">
    No write endpoints. The API is for consumption, not contribution.
  </Card>
</CardGroup>

## Two tiers

|             | Free              | Partner                     |
| ----------- | ----------------- | --------------------------- |
| Sign-up     | Self-serve        | Application + manual review |
| Rate limit  | 60 req/min        | 600 req/min                 |
| Quota       | 100,000 req/month | 5,000,000 req/month         |
| Bulk export | —                 | Included                    |

Both tiers see the same data. Partner unlocks higher limits and bulk endpoints.

```bash theme={"dark"}
$ curl -H "Authorization: Bearer $ELE_KEY" \
    https://api.elestrals.com/v1/cards/kreatherwing

# 200 OK · 14ms · cache HIT
{
  "id": "kreatherwing",
  "name": "Kreatherwing",
  "spirit": ["wind", "fire"],
  "rarity": "ascended",
  "stamina": 240
}
```

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Mint a key, make your first request, parse the response.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and response shape.
  </Card>
</CardGroup>