# vision

> The vision endpoints of the Pokémon TCG API — Identify a card from a photo — each with its parameters, credit cost, minimum plan and a real response.

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

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).

`1` operation under `https://api.pokemontcgapi.com/v1`.

## Operations

| Operation | Endpoint | Cost | Plan |
| --- | --- | --- | --- |
| [Identify a card from a photo](https://pokemontcgapi.com/docs/api/vision/identify) | `POST /v1/vision/identify` | 25 base; add ceil(top_k / 50) for include=index and 4 × ceil(top_k / 25) for include=prices (both add when requested together). With top_k 1–10: 26, 29 or 30 credits. An empty no_match costs only 25. | growth |

**[Identify a card from a photo](https://pokemontcgapi.com/docs/api/vision/identify)** — Send a photograph and get ranked candidate cards. Verified trial accounts get 5 trial recognitions at 25 credits each; ongoing access starts on Growth.