# cards

> Every cards endpoint, with its credit cost and minimum plan.

Source: https://pokemontcgapi.com/docs/api/cards

No key yet? One call gets you one: `POST /v1/accounts/free` with an `Idempotency-Key` header and your email address returns a working key in the response. See the [quickstart](https://pokemontcgapi.com/docs/quickstart).

`3` operations under `https://api.pokemontcgapi.com/v1`.

## Operations

| Operation | Endpoint | Cost | Plan |
| --- | --- | --- | --- |
| [Search cards](https://pokemontcgapi.com/docs/api/cards/search) | `GET /v1/cards` | with include=index, 1 credit per 50 cards requested (the limit), rounded up: a page of 250 costs 5; with include=prices, 4 credits per 25: a page of 250 costs 40 | free |
| [Get a card](https://pokemontcgapi.com/docs/api/cards/get) | `GET /v1/cards/{id}` | 2 with include=prices, the same as GET /v1/cards/{id}/prices | free |
| [Batch cards](https://pokemontcgapi.com/docs/api/cards/batch) | `GET /v1/cards/batch` | 1 per 25 requested ids; include=index: 1 per 50; include=prices: 4 per 25. Rounded up, including unresolved and repeated ids. | free |

**[Search cards](https://pokemontcgapi.com/docs/api/cards/search)** — Query 52,337 cards with Lucene syntax, keyset pagination, field projection and price sorting.

**[Get a card](https://pokemontcgapi.com/docs/api/cards/get)** — Fetch one card by our id or its alternate `{set}-{number}` id, with prices, images and translations on request.

**[Batch cards](https://pokemontcgapi.com/docs/api/cards/batch)** — Resolve up to 100 card ids and report missing ids with verified historical alternatives.
