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 and the pricing.
One page per operation, each with its parameters, a runnable example in three languages, the exact response, and the errors it can return.
For plain catalogue lists, credits are charged per request: use the largest allowed page to reduce calls. Priced includes and batches have their own costs, shown below.
accounts
cards
cards endpoints| Operation | Endpoint | Cost | Plan |
|---|
| Search cards | 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 | GET /v1/cards/{id} | 2 with include=prices, the same as GET /v1/cards/{id}/prices | free |
| Batch cards | 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 |
sets
sets endpoints| Operation | Endpoint | Cost | Plan |
|---|
| List sets | GET /v1/sets | 1 credit | free |
| Get a set | GET /v1/sets/{code} | 1 credit | free |
| Cards in a set | GET /v1/sets/{code}/cards | 1 credit per 50 cards requested (the limit), rounded up; include=index costs the same; with include=prices, 4 credits per 25 | free |
artists
artists endpoints| Operation | Endpoint | Cost | Plan |
|---|
| List artists | GET /v1/artists | 1 credit | free |
| Get an artist | GET /v1/artists/{slug} | 1 credit | free |
series
series endpoints| Operation | Endpoint | Cost | Plan |
|---|
| List series | GET /v1/series | 1 credit | free |
sealed
sealed endpoints| Operation | Endpoint | Cost | Plan |
|---|
| List sealed products | GET /v1/sealed | 1 credit per 50 products requested (the limit), rounded up; include=index costs the same | free |
| Get a sealed product | GET /v1/sealed/{id} | 1 credit | free |
reference
reference endpoints| Operation | Endpoint | Cost | Plan |
|---|
| Reference lists | GET /v1/reference | free, no key needed, cached for a day | free |
status
status endpoints| Operation | Endpoint | Cost | Plan |
|---|
| Service status | GET /v1/status | free, no key needed | free |
prices
changes
changes endpoints| Operation | Endpoint | Cost | Plan |
|---|
| List changes | GET /v1/changes | 1 credit | free |
vision
vision endpoints| Operation | Endpoint | Cost | Plan |
|---|
| Identify a card from a photo | 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 |
centering
centering endpoints| Operation | Endpoint | Cost | Plan |
|---|
| Measure card centering | POST /v1/centering/measure | 25 credits; verified Free trial: 5 measure and 5 confirm calls, independently. Developer excluded. | growth |
| Confirm centering lines | POST /v1/centering/confirm | 5 credits; verified Free trial: 5 measure and 5 confirm calls, independently. Developer excluded. | growth |
| Grade known centering ratios | POST /v1/centering/grade | 1 credits; verified Free trial: 5 measure and 5 confirm calls, independently. Developer excluded. | growth |
| Read centering standards | GET /v1/centering/standards | 1 credits; verified Free trial: 5 measure and 5 confirm calls, independently. Developer excluded. | growth |