MotorAPI Documentation

Authentication

All requests to the API must contain the X-AUTH-TOKEN HTTP header. This header must contain your auth token.

Payload

If your request requires parameters that are not supplied via the URL, these must be sent in JSON format as the body of the request.

API End points

MotorAPI v1	https://v1.motorapi.dk

Vehicle

GET /vehicles Get a list of vehicles, both registered and previously registered.

Get the details for vehicles corresponding to registration number.

Parameters

Name	Type	Required	Description
registration_number	string	required	A single registration number
status	string	optional	Filter to only get a single status. Can be either 'registreret' or 'afmeldt'. This parameter is case insensitive

Success responses

Code	Description
200 Ok	Data returned in body. An empty array is returned in case of no results

GET /vehicles/{reg-no-or-vin} Get details for a currently registered vehicle.

Get the details for vehicle corresponding to registration- or VIN-number.

Success responses

Code	Description
200 Ok	Data returned in body

Error responses

Code	Description
404 Not Found	No such registration- or vin-number

Vehicle Environmental Info

GET /vehicles/{reg-no-or-vin}/environment Get the environmental details for vehicle.

Get the environmental details for vehicle corresponding to registration- or VIN-number, including emission data, fuel type etc.

Success responses

Code	Description
200 Ok	Data returned in body

Error responses

Code	Description
404 Not Found	No such registration- or vin-number

Vehicle Equipment

GET /vehicles/{reg-no-or-vin}/equipment Get a list of equipment registered with the vehicle.

Get the equipment details for vehicle corresponding to registration- or VIN-number. Note that if there's multiple results when querying by registration-number, registered vehicles will be returned, if any - otherwise the first match will be returned.

Success responses

Code	Description
200 Ok	Data returned in body

Error responses

Code	Description
404 Not Found	No such registration- or vin-number

Usage Statistics

GET /usage Get your API usage statistics.

Get your current API usage including today's request count, daily limit, and monthly history.

Note: This endpoint is free and does not count against your daily quota.

Success responses

Code	Description
200 Ok	Usage data returned in body

Error responses

Code	Description
401 Unauthorized	Invalid or missing X-AUTH-TOKEN header

Response Example

{
  "today": {
    "date": "2024-11-30",
    "requests": 47,
    "limit": 100,
    "remaining": 53
  },
  "history": [
    {
      "month": 10,
      "year": 2024,
      "requests": 2150
    },
    {
      "month": 11,
      "year": 2024,
      "requests": 1847
    }
  ]
}