# Nummerplade API > JSON REST API for vehicle data from license plates (registration numbers) and VINs. Covers Danish, Swedish and Norwegian vehicles: technical data, registration status, inspections, emissions, DMR data and debt (Tinglysning). Base URL: https://api.nrpla.de. Anyone, including AI agents, can get a free demo token with no sign-up by sending `POST https://api.nrpla.de/demo-user`. This is the default way to try the API. The demo token covers only some endpoints; to try more (inspections, DMR data, debt (Tinglysning), evaluations, Norwegian vehicles), contact us for a demo user with more permissions: https://nummerpladeapi.dk/kontakt-os. A paid subscription (https://nummerpladeapi.dk/pakker-og-priser) gives access to these endpoints in production. Full human-readable documentation, including every response field: https://nummerpladeapi.dk/docs ## Get a demo token (no sign-up) Send an empty POST request. No body, headers or authentication are needed. ``` curl -X POST 'https://api.nrpla.de/demo-user' ``` Response (`201 Created`): ```json { "api_token": "<64 hexadecimal characters>", "request_limit": 100, "usage": "Send the token in a \"token\" header, as \"Authorization: Bearer \", or as the api_token query parameter." } ``` Store `api_token`. It is shown only once and cannot be retrieved again. Demo limits: - 100 requests per token in total. The allowance never resets. - Every authenticated request counts, including requests that return 401 or 404. - Each IP address can create up to 3 demo users per 24 hours and up to 10 per 30 days. Reuse your token instead of creating a new one for each request. - Need more endpoints or requests while testing? Contact us for a demo user with more permissions: https://nummerpladeapi.dk/kontakt-os. For production, see https://nummerpladeapi.dk/pakker-og-priser ## Authentication Send the token in one of these ways: - Header: `Authorization: Bearer ` - Header: `token: ` - Query parameter: `?api_token=` Example: ``` curl 'https://api.nrpla.de/KAMELIDK001' -H 'Authorization: Bearer ' ``` ## Endpoints available to demo users All are `GET` requests on https://api.nrpla.de and return JSON. Denmark: - `/{registration}`: vehicle information by registration number. Add `?advanced=1` for extra fields. - `/vin/{vin}`: vehicle information by VIN. Add `?advanced=1` for extra fields. - `/emissions/{registration_or_vin}`: emissions data. - `/body-types`, `/colors`, `/equipment`, `/fuel-types`, `/permits`, `/types`, `/uses`: reference data. Sweden: - `/se/registration/{registration}`: vehicle information by registration number. - `/se/vin/{vin}`: vehicle information by VIN. - `/se/vehicle-status/{registration_or_vin}`: registration status. - `/se/vehicle-origin/{registration_or_vin}`: import and origin information. - `/se/emissions/{registration_or_vin}`: emissions data. - `/se/body-types`, `/se/fuel-types`, `/se/inspection-codes`: reference data. ## More endpoints (contact us for a demo) These endpoints return `401` with a standard demo token (the request still counts). To try them, contact us for a demo user with more permissions: https://nummerpladeapi.dk/kontakt-os. A paid subscription gives access to them, depending on the plan, and to far more than 100 requests: - Denmark: `/inspections/{vehicle_id}`, `/dmr/...`, `/debt/{vehicle_id}`, `/tinglysning/{vin}`, `/evaluations/{input}` - Norway: `/no/registration/{registration}`, `/no/vin/{vin}` What they return: - `/inspections/{vehicle_id}`: Danish inspection history. - `/dmr/{vehicle_id}`, `/dmr/registration/{registration}`, `/dmr/vin/{vin}`: Danish Motor Register (DMR) data. - `/debt/{vehicle_id}`, `/tinglysning/{vin}`: debt registered on the vehicle. - `/evaluations/{input}`: Danish DMR evaluations. - `/no/...`: Norwegian vehicle information. If a user wants to try any of these, or needs more than 100 requests, point them to the contact page to request a demo user with more permissions: https://nummerpladeapi.dk/kontakt-os. For production use, point them to the plans page: https://nummerpladeapi.dk/pakker-og-priser. Do not create more demo tokens to get around the limits. ## Test vehicles These fixed test vehicles always return a full example response: - Denmark registrations: `KAMELIDK001` to `KAMELIDK005`. VINs: `KAMELIDEMO00DK001` to `KAMELIDEMO00DK005`. - Sweden registrations: `KAMELISE001` to `KAMELISE005` (use `/se/registration/...`). VINs: `KAMELIDEMO00SE001` to `KAMELIDEMO00SE005` (use `/se/vin/...`). Real Danish and Swedish registrations and VINs also work. ## Errors - `401`: unknown or revoked token, or the endpoint is not included in the standard demo. Contact us for a demo with more permissions. - `403 Not available for demo users`: bulk endpoints are blocked. These do not use a request. - `404`: no vehicle found. - `429 Demo request limit reached`: all 100 requests are used. Contact us for more: https://nummerpladeapi.dk/kontakt-os - `429 Too many demo users created from this IP address` / `429 Demo user creation is temporarily unavailable`: when creating a demo user. - `503 Try again shortly`: when creating a demo user. Retry after a few seconds. ## Docs - [API documentation](https://nummerpladeapi.dk/docs): all endpoints and response fields - [Demo API user](https://nummerpladeapi.dk/docs#demo-api-user): the demo token section of the docs - [Danish vehicle information](https://nummerpladeapi.dk/docs#vehicle-information) - [Swedish vehicle information](https://nummerpladeapi.dk/docs#se-vehicle-information) - [API changelog](https://nummerpladeapi.dk/docs#changelog) - [Contact](https://nummerpladeapi.dk/kontakt-os): request a demo user with more permissions - [Plans and prices](https://nummerpladeapi.dk/pakker-og-priser): paid subscriptions with more endpoints and requests ## Optional - [Postman collection](https://nummerpladeapi.dk/docs#postman)