# cards

> The cards endpoints of the Pokémon TCG API — Search cards, Get a card, Batch cards — each with its parameters, credit cost, minimum plan and a real response.

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. Keep the original Idempotency-Key and body for response replay for up to 24 hours, under the conditions in the quickstart. The trial is 800 credits over 30 days once the address is confirmed, no card; paid plans start at 29 € a month. See the [quickstart](https://pokemontcgapi.com/docs/quickstart) and the [pricing](https://pokemontcgapi.com/pricing).

`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` | 1 credit per 50 cards requested (the limit), rounded up: the default page of 50 costs 1, a page of 250 costs 5; include=index costs the same; 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}` | 1 credit; 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 the whole card catalogue 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.