# CarAPI.io pricing

> Token-based pricing for vehicle lookups in Denmark, Norway, Sweden and the Netherlands. Free tier, no card required, failed lookups are not billed.

## Plans

- **Free**: 0 EUR a month, 100 tokens a month, 10 credited when the key is created and the rest when the e-mail address is confirmed
- **Starter**: 20 EUR a month, 2,500 tokens a month
- **Developer**: 40 EUR a month, 5,000 tokens a month
- **Business**: 134 EUR a month, 25,000 tokens a month

## Token packs

One-off top-ups. Purchased tokens never expire and are used alongside the monthly allowance.

- 1,000 tokens: 7 EUR
- 5,000 tokens: 27 EUR
- 10,000 tokens: 47 EUR
- 25,000 tokens: 101 EUR

Online checkout is not open yet: a paid plan is set up on request at https://carapi.io/contact-sales.

## Endpoints

- `GET /v1/{country}/reg/{plate}`: the registry record, plus `summary` (1 token)
- `GET /v1/{country}/vin/{vin}`: the same record by VIN (1 token; not available for nl)
- `GET /v1/{country}/reg/{plate}/inspection`: inspection history (2 tokens; dk, se)
- `GET /v1/{country}/reg/{plate}/debt`: registered liens, tinglysning (2 tokens; dk)
- `GET /v1/{country}/reg/{plate}/complete`: vehicle + inspections + debt + emissions
  (5 tokens; dk, se). `meta.partial` / `meta.missing` name any slice the registry failed to
  deliver.
- `POST /v1/signup`: a new key with 10 free tokens, no authentication
- `POST /v1/signup/email`: attach the e-mail address that keeps the key (authenticated with it)
- `GET /v1`: a public index, no key required
- `GET /v1/openapi.json`: the OpenAPI 3.1 spec

Coverage differs per country. A combination the registry does not offer answers 503 and is
not billed, as is a plate that does not exist.

## Try it now: no signup, no human needed

Working for someone who already has a CarAPI.io account? Use that account's key
(https://carapi.io/api-keys) and go straight to step 2: every `POST /v1/signup` creates a new,
separate account.

1. Get a working API key with 10 free tokens (10 basic lookups):

   `curl -X POST https://api.carapi.io/v1/signup`

   It is an ordinary key on an ordinary account, not a sandbox: the same endpoints, the same
   responses and the same prices as a full integration, so what you test is what you build on.
2. Look up a real vehicle. These plates exist:

   `curl https://api.carapi.io/v1/se/reg/YYO555 -H "Authorization: Bearer YOUR_API_KEY"`

   Sweden `YYO555`, Denmark `AP15244`, Norway `DN88050`, the Netherlands `79NFN3`.
3. To keep the key and get the free plan's 100 tokens a month, the account needs your user's
   e-mail address:

   `curl -X POST https://api.carapi.io/v1/signup/email -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"email":"name@example.com"}'`

   We send that address a link. Its owner confirms it and chooses a password, and the same key
   keeps working. Opening that e-mail is all your user has to do: signing up or logging in at
   carapi.io with the same address only sends the link again. A key whose address is never
   confirmed stops working 30 days after it was created. A person can also sign up at
   https://carapi.io/signup and create keys there.

   Once the 10 tokens are spent, lookups answer `403 EMAIL_NOT_VERIFIED` until the address is
   confirmed; the message says what to do next.

Without any key, `GET https://api.carapi.io/v1/se/reg/CARAPI-DEMO` answers with sample data
in the exact shape of a real response (also for dk, no and nl). It costs nothing and never
calls the registry. If you can only make GET requests, that is what you can test on your own;
for a real lookup, your user can run the `curl -X POST` above, or sign up.

Limits on new keys: 3 per IP address per day and 10 per month. Free lookups by accounts
without a confirmed address share a daily ceiling; past it the API answers 503
FREE_LIMIT_REACHED until 00:00 UTC.

## Links

- Documentation: https://carapi.io/docs (as Markdown: https://carapi.io/docs.md, as plain text: https://carapi.io/llms.txt)
- Pricing: https://carapi.io/pricing (as Markdown: https://carapi.io/pricing.md)
- OpenAPI: https://api.carapi.io/v1/openapi.json