{ "info": { "name": "Motorbay API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "v1" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Api-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.motorbay.app" }, { "key": "apiKey", "value": "" } ], "item": [ { "name": "Vehicles", "item": [ { "name": "Get a vehicle by ID", "request": { "method": "GET", "description": "Retrieves a vehicle record by its ID. Includes basic registration and classification data. Add include=engine,inspection (or include=all) to get the vehicle's parts in the same answer, as one request.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":id" ], "query": [ { "key": "include", "value": "", "disabled": true, "description": "Parts of the vehicle to add to the answer, comma-separated (include=engine,inspection) or repeated (include=engine&include=inspection). all adds every part. Each part is a property of the same name holding exactly what its sub-endpoint returns: technicalDetails, engine, environmentalInformation, inspection, check, calculated and history the object (null where the sub-endpoint answers 204), and fuelTypes, equipment, secondaryUsages, blockingReasons, permits and leasingPeriods every item of the list, unpaged (the longest, equipment, held at most 26 items per vehicle in the 10 Oct 2026 test data). Without include the answer is unchanged and has none of these properties. A value not listed is a 400 ValidationFailed with IncludeInvalid in errors naming it. The call counts as one request, however many parts it adds." }, { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "Get a vehicle by VIN", "request": { "method": "GET", "description": "Retrieves a vehicle by its globally unique VIN (Vehicle Identification Number). Add include=engine,inspection (or include=all) to get the vehicle's parts in the same answer, as one request.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/vin/:vin", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "vin", ":vin" ], "query": [ { "key": "include", "value": "", "disabled": true, "description": "Parts of the vehicle to add to the answer, comma-separated (include=engine,inspection) or repeated (include=engine&include=inspection). all adds every part. Each part is a property of the same name holding exactly what its sub-endpoint returns: technicalDetails, engine, environmentalInformation, inspection, check, calculated and history the object (null where the sub-endpoint answers 204), and fuelTypes, equipment, secondaryUsages, blockingReasons, permits and leasingPeriods every item of the list, unpaged (the longest, equipment, held at most 26 items per vehicle in the 10 Oct 2026 test data). Without include the answer is unchanged and has none of these properties. A value not listed is a 400 ValidationFailed with IncludeInvalid in errors naming it. The call counts as one request, however many parts it adds." }, { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vin", "value": "" } ] } } }, { "name": "Get a vehicle by registration number", "request": { "method": "GET", "description": "Looks up a vehicle by its Danish registration number (plate). Case, spaces and hyphens in the plate are ignored. Plates are reused, so one plate can belong to several vehicles. The lookup returns the vehicle that is currently registered. If there is more than one, the one with the newest registration status date wins, and on equal dates the highest id. If none is registered, it returns the vehicle with the newest registration status date (vehicles without one come last), and its registrationStatus says it is not registered. The same plate always gives the same vehicle for the same dataset. To see every vehicle that has carried the plate, use GET /v1/vehicles?registrationNumber=. 404 VehicleNotFound means no vehicle in the current extract has the plate. Add include=engine,inspection (or include=all) to get the vehicle's parts in the same answer, as one request.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/plate/:plate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "plate", ":plate" ], "query": [ { "key": "include", "value": "", "disabled": true, "description": "Parts of the vehicle to add to the answer, comma-separated (include=engine,inspection) or repeated (include=engine&include=inspection). all adds every part. Each part is a property of the same name holding exactly what its sub-endpoint returns: technicalDetails, engine, environmentalInformation, inspection, check, calculated and history the object (null where the sub-endpoint answers 204), and fuelTypes, equipment, secondaryUsages, blockingReasons, permits and leasingPeriods every item of the list, unpaged (the longest, equipment, held at most 26 items per vehicle in the 10 Oct 2026 test data). Without include the answer is unchanged and has none of these properties. A value not listed is a 400 ValidationFailed with IncludeInvalid in errors naming it. The call counts as one request, however many parts it adds." }, { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "plate", "value": "AB12345", "description": "The registration number. Case, spaces and hyphens are ignored, so \"ab 12 345\" and \"AB-12345\" both mean AB12345. What remains must be 1 to 10 characters from A-Z, 0-9, Æ, Ø and Å, or the request is a 400 with RegistrationNumberInvalid in errors." } ] } } }, { "name": "Get a vehicle by registration number or VIN", "request": { "method": "GET", "description": "Looks up a vehicle by registration number or VIN, in one route. A value of exactly 17 characters from A-Z and 0-9 that has no I, O or Q (case is ignored) is a VIN, and the answer is exactly what GET /v1/vehicles/vin/{vin} returns. Anything else is a plate, read and validated as GET /v1/vehicles/plate/{plate} does it, and the answer is exactly what that returns, including its 400 for a malformed plate. Add include=engine,inspection (or include=all) to get the vehicle's parts in the same answer, as one request. 404 VehicleNotFound means no vehicle in the current extract has the VIN or plate.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/lookup/:plateOrVin", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "lookup", ":plateOrVin" ], "query": [ { "key": "include", "value": "", "disabled": true, "description": "Parts of the vehicle to add to the answer, comma-separated (include=engine,inspection) or repeated (include=engine&include=inspection). all adds every part. Each part is a property of the same name holding exactly what its sub-endpoint returns: technicalDetails, engine, environmentalInformation, inspection, check, calculated and history the object (null where the sub-endpoint answers 204), and fuelTypes, equipment, secondaryUsages, blockingReasons, permits and leasingPeriods every item of the list, unpaged (the longest, equipment, held at most 26 items per vehicle in the 10 Oct 2026 test data). Without include the answer is unchanged and has none of these properties. A value not listed is a 400 ValidationFailed with IncludeInvalid in errors naming it. The call counts as one request, however many parts it adds." }, { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "plateOrVin", "value": "AB12345", "description": "A VIN or a registration number. Exactly 17 characters from A-Z and 0-9 without I, O or Q is a VIN; anything else is a plate. Case, spaces and hyphens are ignored, so \"ab 12 345\" and \"AB-12345\" both mean AB12345. What remains must be 1 to 10 characters from A-Z, 0-9, Æ, Ø and Å, or the request is a 400 with RegistrationNumberInvalid in errors." } ] } } }, { "name": "Get vehicles by registration numbers, up to 500 at once", "request": { "method": "POST", "description": "Looks up 1 to 500 plates in one call. Each plate is read, and each vehicle picked, exactly as GET /v1/vehicles/plate/{plate} does it. The answer has one item per plate sent, in the order sent: found with the vehicle, or not found with error.code VehicleNotFound, or not valid with error.code InvalidPlate. An invalid plate is reported on its item and does not fail the call. The quota is checked for one request per distinct valid plate (a plate sent twice, or in another spelling of the same plate, counts once; invalid plates don't count; a call with no valid plate counts as one). The quota is checked for all of them before any lookup: if the account can't cover them all, the whole call is a 429 QuotaExceeded, with no results and nothing counted. The call then costs the plates found: plates not found are given back, and an answer that is not 2xx costs nothing. For the per-minute rate limit the call is one request. A body that is not {\"plates\": [...]} with 1 to 500 strings is a 400 ValidationFailed. A body over 64 KB is a 413 PayloadTooLarge: before it is read when it declares its length, after the key and quota checks when it is chunked.", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/vehicles/plates", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "plates" ] }, "body": { "mode": "raw", "raw": "{\n \"plates\": [\n \"AB12345\",\n \"CD67890\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get values Motorbay calculates for a vehicle", "request": { "method": "GET", "description": "Returns values Motorbay calculates from the vehicle's extract data: horsepower (hk), age, km per year, power to weight, whether it is electric or a plug-in hybrid, the manufacturer region and country from the VIN, and whether the model year the register records is possible. None of these is in Motorstyrelsen's extract, and the raw values on the other vehicle resources are not changed. Each field says how it is calculated. A value is null when the data it needs is missing.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/calculated", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "calculated" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Get a vehicle's history of plates, statuses, inspections, blocks and leasing", "request": { "method": "GET", "description": "Returns what changed about the vehicle from one weekly extract of Motorstyrelsen's register to the next: its registration numbers, statuses, registration statuses and inspections, each with its odometer reading. Each list is newest first. observedOn is the day of the extract a value was first seen in, and changedOn the day the register gives for the change, when it gives one. The extract holds only each week's state, so history starts at observedSince, the earliest extract Motorbay holds for the vehicle: an earlier plate or inspection is not missing from the register, Motorbay just has no extract from then. Registration numbers are reused, and personal plates move between vehicles, so a plate in plates may be on another vehicle now. A vehicle with no history yet gets empty lists and observedSince null. blocks and leasingPeriods hold each set of blocks or leasing periods the vehicle had, the whole set each time it changed, an empty set when none was left. They start at blocksObservedSince and leasingPeriodsObservedSince, the same day for every vehicle, with each vehicle's set that day: until then both are null and the lists say nothing. With units=imperial each inspection adds converted, as on /inspection. One call is one request.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/history", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "history" ], "query": [ { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Get a vehicle's technical details", "request": { "method": "GET", "description": "Returns detailed technical specifications for the specified vehicle, such as weight, seating, and dimensions.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/technical-details", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "technical-details" ], "query": [ { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Get a vehicle's environmental information", "request": { "method": "GET", "description": "Retrieves environmental attributes for a vehicle, including emissions, filters, and classification data.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/environmental-information", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "environmental-information" ], "query": [ { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Get a vehicle's engine information", "request": { "method": "GET", "description": "Returns engine-specific details such as displacement, power, odometer readings, and noise levels.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/engine", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "engine" ], "query": [ { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Get a vehicle's latest inspection", "request": { "method": "GET", "description": "Provides the most recent inspection report for the specified vehicle, including type, result, and odometer reading.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/inspection", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "inspection" ], "query": [ { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Search vehicles", "request": { "method": "GET", "description": "Performs a filtered search across vehicles based on attributes such as make, kind, usage, color, model year, registration status, registration number, primary fuel type and first registration date. Returns paginated results.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles" ], "query": [ { "key": "makeId", "value": "", "disabled": true }, { "key": "kindId", "value": "", "disabled": true }, { "key": "usageId", "value": "", "disabled": true }, { "key": "colorId", "value": "", "disabled": true }, { "key": "fromModelYear", "value": "", "disabled": true }, { "key": "toModelYear", "value": "", "disabled": true }, { "key": "sortBy", "value": "", "disabled": true, "description": "The order of the results. A leading \"-\" sorts descending. Vehicles without the value come last in either direction. Ties are broken by id." }, { "key": "page", "value": "", "disabled": true, "description": "Page number, from 1. page × pageSize may be at most 10,000 (SearchTooDeep)." }, { "key": "pageSize", "value": "", "disabled": true }, { "key": "registrationNumber", "value": "AB12345", "disabled": true, "description": "Every vehicle that has carried this registration number, its history. Case, spaces and hyphens are ignored, so \"ab 12 345\" and \"AB-12345\" both mean AB12345. What remains must be 1 to 10 characters from A-Z, 0-9, Æ, Ø and Å, or the request is a 400 with RegistrationNumberInvalid in errors. Without sortBy the vehicles come in the same order as GET /v1/vehicles/plate/{plate} picks from, so the first is the one it returns. No match is a 200 with an empty data array." }, { "key": "registrationStatus", "value": "registered", "disabled": true, "description": "Only vehicles with this registration status, spelled as a vehicle's registrationStatus. Any other value is a 400 with RegistrationStatusInvalid." }, { "key": "fuelTypeId", "value": "3", "disabled": true, "description": "Only vehicles with this primary fuel type (GET /v1/fuel-types): the fuel GET /v1/vehicles/{id}/fuel-types lists first, with isPrimary true. Leaves out vehicles without a primary fuel." }, { "key": "fromFirstRegisteredOn", "value": "2020-01-01", "disabled": true, "description": "Only vehicles first registered on or after this day, as YYYY-MM-DD, compared with a vehicle's firstRegisteredOn. Leaves out vehicles without a first registration date. Anything else is a 400 with FirstRegisteredOnInvalid. Not on GET /v1/statistics/vehicles." }, { "key": "toFirstRegisteredOn", "value": "2020-12-31", "disabled": true, "description": "Only vehicles first registered on or before this day, as YYYY-MM-DD, compared with a vehicle's firstRegisteredOn. Leaves out vehicles without a first registration date. Anything else is a 400 with FirstRegisteredOnInvalid. Not on GET /v1/statistics/vehicles." } ] } } } ] }, { "name": "Colors", "item": [ { "name": "Get a color", "request": { "method": "GET", "description": "Fetches a specific vehicle color by ID, including original naming.", "header": [], "url": { "raw": "{{baseUrl}}/v1/colors/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "colors", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List colors", "request": { "method": "GET", "description": "Retrieves a paginated list of all defined vehicle colors in the registry.", "header": [], "url": { "raw": "{{baseUrl}}/v1/colors", "host": [ "{{baseUrl}}" ], "path": [ "v1", "colors" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } } ] }, { "name": "Makes", "item": [ { "name": "Get a make", "request": { "method": "GET", "description": "Retrieves a vehicle manufacturer (make) by its unique ID.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List makes", "request": { "method": "GET", "description": "Returns a paginated list of all recognized vehicle makes.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } } ] }, { "name": "Models", "item": [ { "name": "Get a model", "request": { "method": "GET", "description": "Gets a specific vehicle model under the given manufacturer.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models", ":id" ], "variable": [ { "key": "makeId", "value": "" }, { "key": "id", "value": "" } ] } } }, { "name": "List a make's models", "request": { "method": "GET", "description": "Lists all models associated with the specified vehicle make.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "makeId", "value": "" } ] } } } ] }, { "name": "Variants", "item": [ { "name": "Get a variant", "request": { "method": "GET", "description": "Retrieves a specific variant for a given model and make combination.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models/:modelId/variants/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models", ":modelId", "variants", ":id" ], "variable": [ { "key": "makeId", "value": "" }, { "key": "modelId", "value": "" }, { "key": "id", "value": "" } ] } } }, { "name": "List a model's variants", "request": { "method": "GET", "description": "Lists all variants under a specific model for the given make.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models/:modelId/variants", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models", ":modelId", "variants" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "makeId", "value": "" }, { "key": "modelId", "value": "" } ] } } } ] }, { "name": "Designation Types", "item": [ { "name": "Get a designation type", "request": { "method": "GET", "description": "Gets a designation type by ID for a specific model under a given make.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models/:modelId/designation-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models", ":modelId", "designation-types", ":id" ], "variable": [ { "key": "makeId", "value": "" }, { "key": "modelId", "value": "" }, { "key": "id", "value": "" } ] } } }, { "name": "List a model's designation types", "request": { "method": "GET", "description": "Lists all designation types defined for the given model and make.", "header": [], "url": { "raw": "{{baseUrl}}/v1/makes/:makeId/models/:modelId/designation-types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "makes", ":makeId", "models", ":modelId", "designation-types" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "makeId", "value": "" }, { "key": "modelId", "value": "" } ] } } } ] }, { "name": "Emission Standards", "item": [ { "name": "Get an emission standard", "request": { "method": "GET", "description": "Retrieves a specific emission standard by ID, including naming details.", "header": [], "url": { "raw": "{{baseUrl}}/v1/emission-standards/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "emission-standards", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List emission standards", "request": { "method": "GET", "description": "Returns a paginated list of known vehicle emission standards.", "header": [], "url": { "raw": "{{baseUrl}}/v1/emission-standards", "host": [ "{{baseUrl}}" ], "path": [ "v1", "emission-standards" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } } ] }, { "name": "Fuel Types", "item": [ { "name": "Get a fuel type", "request": { "method": "GET", "description": "Retrieves a specific fuel type by ID, such as Benzin, Diesel or El.", "header": [], "url": { "raw": "{{baseUrl}}/v1/fuel-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "fuel-types", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List fuel types", "request": { "method": "GET", "description": "Returns a paginated list of known fuel types.", "header": [], "url": { "raw": "{{baseUrl}}/v1/fuel-types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "fuel-types" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "List a vehicle's fuel types", "request": { "method": "GET", "description": "Lists the fuels a vehicle runs on, primary first, with fuel efficiency, CO2 emissions and electric consumption per fuel.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/fuel-types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "fuel-types" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true }, { "key": "units", "value": "", "disabled": true, "description": "The units for converted. metric (the default) is the answer as it has always been, with no converted. imperial adds converted to each part with a measured value: weights in lb, lengths in in, displacement in in³, speed in mph, the odometer in thousands of miles, fuel efficiency in mpg (US unless mpg=uk), CO₂ in g/mi, electric consumption in Wh/mi and emissions in mg/mi. converted names the unit of every value. The raw fields never change: they stay in Motorstyrelsen's units, whatever is asked for. On a vehicle lookup it applies to the parts include adds. Anything else is a 400 with UnitsInvalid." }, { "key": "power", "value": "", "disabled": true, "description": "The unit of maximumPower in converted: kw (the default) or hp, mechanical horsepower (745.7 W), rounded to 1 decimal: 100 kW is 134.1 hp. Not the metric horsepower (hk, 735.5 W, 136 for 100 kW) that horsepower on /calculated gives. Works with either units, so units=metric&power=hp keeps kg and adds hp. power=hp alone adds converted. Anything else is a 400 with UnitsInvalid." }, { "key": "mpg", "value": "", "disabled": true, "description": "With units=imperial, which gallon fuel efficiency is per: us (the default, 3.785411784 l, mpgUs) or uk (4.54609 l, mpgUk). 20 km/l is 47.0 mpg US and 56.5 mpg UK. Without units=imperial it is a 400 with UnitsInvalid." } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Equipment", "item": [ { "name": "Get an equipment type", "request": { "method": "GET", "description": "Fetches metadata for a specific equipment feature by ID.", "header": [], "url": { "raw": "{{baseUrl}}/v1/equipment/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "equipment", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List equipment types", "request": { "method": "GET", "description": "Lists all registered vehicle equipment items with pagination support.", "header": [], "url": { "raw": "{{baseUrl}}/v1/equipment", "host": [ "{{baseUrl}}" ], "path": [ "v1", "equipment" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "List a vehicle's equipment", "request": { "method": "GET", "description": "Retrieves all equipment associated with a specific vehicle instance.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/equipment", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "equipment" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Kinds", "item": [ { "name": "Get a vehicle kind", "request": { "method": "GET", "description": "Retrieves a specific kind (type category) of vehicle by ID.", "header": [], "url": { "raw": "{{baseUrl}}/v1/kinds/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "kinds", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List vehicle kinds", "request": { "method": "GET", "description": "Lists all vehicle kinds, such as personal car, van, or truck.", "header": [], "url": { "raw": "{{baseUrl}}/v1/kinds", "host": [ "{{baseUrl}}" ], "path": [ "v1", "kinds" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } } ] }, { "name": "Usages", "item": [ { "name": "Get a usage", "request": { "method": "GET", "description": "Returns a specific vehicle usage type, such as private or commercial.", "header": [], "url": { "raw": "{{baseUrl}}/v1/usages/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "usages", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List usages", "request": { "method": "GET", "description": "Lists all available primary usage types defined in the registry.", "header": [], "url": { "raw": "{{baseUrl}}/v1/usages", "host": [ "{{baseUrl}}" ], "path": [ "v1", "usages" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "List a vehicle's secondary usages", "request": { "method": "GET", "description": "Retrieves secondary usage types (e.g., occasional commercial use) registered for a vehicle.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/secondary-usages", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "secondary-usages" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Blocking Reasons", "item": [ { "name": "Get a blocking reason", "request": { "method": "GET", "description": "Retrieves a specific blocking reason by ID, such as Totalskadet køretøj or Mangel.", "header": [], "url": { "raw": "{{baseUrl}}/v1/blocking-reasons/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "blocking-reasons", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List blocking reasons", "request": { "method": "GET", "description": "Returns a paginated list of the blocking reasons a vehicle can have, such as a total loss, damage or a defect.", "header": [], "url": { "raw": "{{baseUrl}}/v1/blocking-reasons", "host": [ "{{baseUrl}}" ], "path": [ "v1", "blocking-reasons" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "List a vehicle's blocks", "request": { "method": "GET", "description": "Lists the blocks registered on a vehicle in the latest extract we loaded, such as a total loss, damage, a defect or a call-in for registration. An empty list means no block was recorded in that extract.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/blocking-reasons", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "blocking-reasons" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Permits", "item": [ { "name": "Get a permit type", "request": { "method": "GET", "description": "Retrieves a specific permit type by ID, such as Stelnummer Genihugget (a re-stamped VIN).", "header": [], "url": { "raw": "{{baseUrl}}/v1/permit-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "permit-types", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List permit types", "request": { "method": "GET", "description": "Returns a paginated list of known permit types.", "header": [], "url": { "raw": "{{baseUrl}}/v1/permit-types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "permit-types" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "List a vehicle's permits", "request": { "method": "GET", "description": "Lists the permits registered on a vehicle, newest first, such as a re-stamped VIN or a trailer coupling. Permit comments are not included.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/permits", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "permits" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Leasing Periods", "item": [ { "name": "List a vehicle's leasing periods", "request": { "method": "GET", "description": "Lists the leasing periods registered on a vehicle, newest start first, as calendar dates.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/leasing-periods", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "leasing-periods" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Vehicle Check", "item": [ { "name": "Check a used vehicle", "request": { "method": "GET", "description": "Returns the risk signals for a used vehicle in one answer: status and registration status, blocks (total loss, damaged, blocked, defect, called in for registration), traffic damage, a re-stamped VIN, a leasing period covering today, the latest inspection and the plate's expiry, plus flags with a severity. It reflects the latest weekly extract we loaded; a vehicle with no flags may still have problems the extract does not record.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/check", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "check" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Check a used vehicle by registration number", "request": { "method": "GET", "description": "Returns the risk signals for a used vehicle in one answer: status and registration status, blocks (total loss, damaged, blocked, defect, called in for registration), traffic damage, a re-stamped VIN, a leasing period covering today, the latest inspection and the plate's expiry, plus flags with a severity. It reflects the latest weekly extract we loaded; a vehicle with no flags may still have problems the extract does not record. Finds the vehicle by registration number the same way as /v1/vehicles/plate/{plate}.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/plate/:plate/check", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "plate", ":plate", "check" ], "variable": [ { "key": "plate", "value": "" } ] } } }, { "name": "Check a used vehicle by VIN", "request": { "method": "GET", "description": "Returns the risk signals for a used vehicle in one answer: status and registration status, blocks (total loss, damaged, blocked, defect, called in for registration), traffic damage, a re-stamped VIN, a leasing period covering today, the latest inspection and the plate's expiry, plus flags with a severity. It reflects the latest weekly extract we loaded; a vehicle with no flags may still have problems the extract does not record. Finds the vehicle by VIN.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/vin/:vin/check", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "vin", ":vin", "check" ], "variable": [ { "key": "vin", "value": "" } ] } } } ] }, { "name": "Vehicle Recalls", "item": [ { "name": "EU Safety Gate recalls that may cover a vehicle", "request": { "method": "GET", "description": "Returns the EU Safety Gate motor vehicle alerts (recalls and other measures published by EU and EEA authorities) that may cover a vehicle, matched on its EU type approval and production dates, with how each matched. A match is not on the VIN: check the VIN with the manufacturer or a dealer. Only vehicles with an EU type approval number in the register can be matched, about half the Danish fleet (canMatch says which), so an empty list means no matching alert was found, not that the vehicle has no recall. Alerts are in English as published and are refreshed weekly; show the attribution in source wherever you show them.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/:vehicleId/recalls", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", ":vehicleId", "recalls" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "EU Safety Gate recalls by registration number", "request": { "method": "GET", "description": "Returns the EU Safety Gate motor vehicle alerts (recalls and other measures published by EU and EEA authorities) that may cover a vehicle, matched on its EU type approval and production dates, with how each matched. A match is not on the VIN: check the VIN with the manufacturer or a dealer. Only vehicles with an EU type approval number in the register can be matched, about half the Danish fleet (canMatch says which), so an empty list means no matching alert was found, not that the vehicle has no recall. Alerts are in English as published and are refreshed weekly; show the attribution in source wherever you show them. Finds the vehicle by registration number the same way as /v1/vehicles/plate/{plate}.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/plate/:plate/recalls", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "plate", ":plate", "recalls" ], "variable": [ { "key": "plate", "value": "" } ] } } }, { "name": "EU Safety Gate recalls by VIN", "request": { "method": "GET", "description": "Returns the EU Safety Gate motor vehicle alerts (recalls and other measures published by EU and EEA authorities) that may cover a vehicle, matched on its EU type approval and production dates, with how each matched. A match is not on the VIN: check the VIN with the manufacturer or a dealer. Only vehicles with an EU type approval number in the register can be matched, about half the Danish fleet (canMatch says which), so an empty list means no matching alert was found, not that the vehicle has no recall. Alerts are in English as published and are refreshed weekly; show the attribution in source wherever you show them. Finds the vehicle by VIN.", "header": [], "url": { "raw": "{{baseUrl}}/v1/vehicles/vin/:vin/recalls", "host": [ "{{baseUrl}}" ], "path": [ "v1", "vehicles", "vin", ":vin", "recalls" ], "variable": [ { "key": "vin", "value": "" } ] } } } ] }, { "name": "Dataset", "item": [ { "name": "Describe the data being served", "request": { "method": "GET", "description": "Describes the Motorstyrelsen extract currently being served: when Motorstyrelsen published it, when it was imported, and how many vehicles it holds. Returns 503 with code 'DatasetNotLoaded' before the first import completes.", "header": [], "url": { "raw": "{{baseUrl}}/v1/dataset", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dataset" ] } } } ] }, { "name": "Account", "item": [ { "name": "Get this month's usage", "request": { "method": "GET", "description": "Returns the account's usage this calendar month (UTC): requests counted, the plan's included requests, the hard limit and what remains of it (null on paid plans, which have none), and the requests counted with the API key that asks. Only answered (2xx) requests count toward the plan, and a batch counts the plates it found. This call is free: it does not count toward the plan. It counts toward the per-minute rate limit like every request.", "header": [], "url": { "raw": "{{baseUrl}}/v1/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "usage" ] } } } ] }, { "name": "Statistics", "item": [ { "name": "Count vehicles, optionally grouped", "request": { "method": "GET", "description": "Counts the vehicles in the served extract that match the filters, the same filters as GET /v1/vehicles except registrationNumber and the first registration dates. Without groupBy the answer is the total. With groupBy (one or two of make, kind, usage, color, modelYear, registrationStatus, fuelType, bodyType, firstRegisteredYear, firstRegisteredMonth, comma separated) it also returns the groups, largest count first, at most limit of them (default 50, max 1000). Each group has only the fields it is grouped by, its count, and share: its percent of total, with two decimals. With two fields a group also has shareOfParent, its percent of the vehicles with the same first field, so groupBy=make,fuelType gives each make's fuel mix. Makes, kinds, usages, colors and fuel types come with their names, as on a vehicle. fuelType is the primary fuel, the one fuelTypeId filters on. bodyType is the vehicle's, with unknown a group of its own (62 % of the register on 16 Oct 2026). firstRegisteredYear and firstRegisteredMonth (YYYY-MM) are the year and month of a vehicle's firstRegisteredOn. A grouped field is null for vehicles without the value. total counts every matching vehicle and groupCount every group, also those past the limit. With average (one or more of odometerReading, maximumPower, ownWeight, totalWeight, comma separated) the answer and each group also have averages: per metric asked for, value (the mean, one decimal, null without values), unit and basedOn, how many vehicles had a plausible value. odometerReading is the latest inspection's, in thousands of km, and a reading of 0 is left out. maximumPower is in kW, the weights in kg. The extract holds values no vehicle has, such as an own weight of 555,555,555,555,555,555 kg, so a value outside its kind's plausible range is left out of the average, not clipped: passenger cars (kind 1) and vans (3): odometerReading 1 to 2,000, maximumPower 1 to 1,000, ownWeight 200 to 4,000, totalWeight 300 to 5,000; motorcycles (7): odometerReading 1 to 500, maximumPower 1 to 400, ownWeight 30 to 1,000, totalWeight 50 to 1,500; mopeds (16, 17): odometerReading 1 to 200, maximumPower 0.1 to 8, ownWeight 10 to 400, totalWeight 30 to 1,000; every other kind: odometerReading 1 to 5,000, maximumPower 0.1 to 2,000, ownWeight 10 to 150,000, totalWeight 10 to 300,000. The counts describe one weekly extract: the Motorbay-Data-As-Of header says which. They are exact for it, and equal the totalCount GET /v1/vehicles reports for the same filters. One call is one request. Example: registered passenger cars by make is ?kindId=1®istrationStatus=registered&groupBy=make, and the average power of new cars by month is ?kindId=1&groupBy=firstRegisteredMonth&average=maximumPower.", "header": [], "url": { "raw": "{{baseUrl}}/v1/statistics/vehicles", "host": [ "{{baseUrl}}" ], "path": [ "v1", "statistics", "vehicles" ], "query": [ { "key": "makeId", "value": "", "disabled": true, "description": "Only this make (GET /v1/makes)." }, { "key": "kindId", "value": "1", "disabled": true, "description": "Only this kind (GET /v1/kinds)." }, { "key": "usageId", "value": "", "disabled": true, "description": "Only this primary usage (GET /v1/usages)." }, { "key": "colorId", "value": "", "disabled": true, "description": "Only this color (GET /v1/colors)." }, { "key": "fromModelYear", "value": "", "disabled": true, "description": "Only model years from this one, inclusive. Leaves out vehicles without a model year." }, { "key": "toModelYear", "value": "", "disabled": true, "description": "Only model years up to this one, inclusive. Leaves out vehicles without a model year." }, { "key": "registrationStatus", "value": "registered", "disabled": true, "description": "Only vehicles with this registration status, spelled as a vehicle's registrationStatus. Any other value is a 400 with RegistrationStatusInvalid." }, { "key": "groupBy", "value": "make,modelYear", "disabled": true, "description": "One or two fields to group by, comma separated, from: make, kind, usage, color, modelYear, registrationStatus, fuelType, bodyType, firstRegisteredYear, firstRegisteredMonth. Omit it for just the total. Anything else is a 400 with GroupByInvalid, three or more GroupByTooMany." }, { "key": "limit", "value": "", "disabled": true, "description": "How many groups to return at most, 1 to 1000 (LimitOutOfRange). The largest come first." }, { "key": "fuelTypeId", "value": "3", "disabled": true, "description": "Only vehicles with this primary fuel type (GET /v1/fuel-types): the fuel GET /v1/vehicles/{id}/fuel-types lists first, with isPrimary true. Leaves out vehicles without a primary fuel." }, { "key": "average", "value": "odometerReading,maximumPower", "disabled": true, "description": "Metrics to average, comma separated, from: odometerReading, maximumPower, ownWeight, totalWeight. Adds averages to the answer and to each group, with only these metrics. Omit it for no averages. An unknown metric, one named twice, or none is a 400 with AverageInvalid." } ] } } } ] }, { "name": "Watches", "item": [ { "name": "List the vehicles the account watches", "request": { "method": "GET", "description": "Lists the vehicles the account watches, by vehicle id. Every key of the account sees the same list. Free: it doesn't count toward the plan.", "header": [], "url": { "raw": "{{baseUrl}}/v1/watches/vehicles", "host": [ "{{baseUrl}}" ], "path": [ "v1", "watches", "vehicles" ], "query": [ { "key": "page", "value": "", "disabled": true }, { "key": "pageSize", "value": "", "disabled": true } ] } } }, { "name": "Whether the account watches a vehicle", "request": { "method": "GET", "description": "Whether the account watches this vehicle. 404 WatchNotFound when it doesn't. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/watches/vehicles/:vehicleId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "watches", "vehicles", ":vehicleId" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Watch a vehicle", "request": { "method": "PUT", "description": "Watches a vehicle. Watching one already watched changes nothing. After each weekly import, every enabled endpoint gets one signed POST per watched vehicle that changed. Needs a paid plan, and the plan caps how many vehicles an account watches. Free: it doesn't count toward the plan.", "header": [], "url": { "raw": "{{baseUrl}}/v1/watches/vehicles/:vehicleId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "watches", "vehicles", ":vehicleId" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } }, { "name": "Stop watching a vehicle", "request": { "method": "DELETE", "description": "Stops watching a vehicle. Deliveries already queued for it are withdrawn, not sent. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/watches/vehicles/:vehicleId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "watches", "vehicles", ":vehicleId" ], "variable": [ { "key": "vehicleId", "value": "" } ] } } } ] }, { "name": "Webhooks", "item": [ { "name": "List the account's webhook endpoints", "request": { "method": "GET", "description": "Lists the account's webhook endpoints, oldest first. The signing secrets are never shown again. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/webhooks/endpoints", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", "endpoints" ] } } }, { "name": "Register a webhook endpoint", "request": { "method": "POST", "description": "Registers an https endpoint for the account's deliveries and returns its signing secret, this once. Store the secret: it can't be read again, only rotated. Needs a paid plan, and the plan caps how many endpoints an account has. Free: it doesn't count toward the plan.", "header": [], "url": { "raw": "{{baseUrl}}/v1/webhooks/endpoints", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", "endpoints" ] } } }, { "name": "Get a webhook endpoint", "request": { "method": "GET", "description": "One of the account's webhook endpoints, without its secret. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/webhooks/endpoints/:endpointId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", "endpoints", ":endpointId" ], "variable": [ { "key": "endpointId", "value": "" } ] } } }, { "name": "Delete a webhook endpoint", "request": { "method": "DELETE", "description": "Deletes the endpoint and its queued deliveries. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/webhooks/endpoints/:endpointId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", "endpoints", ":endpointId" ], "variable": [ { "key": "endpointId", "value": "" } ] } } }, { "name": "Rotate a webhook endpoint's signing secret", "request": { "method": "POST", "description": "Gives the endpoint a new signing secret and returns it, this once. The old secret keeps signing for 24 hours next to the new one, so you can switch without missing a delivery. Free.", "header": [], "url": { "raw": "{{baseUrl}}/v1/webhooks/endpoints/:endpointId/rotate-secret", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", "endpoints", ":endpointId", "rotate-secret" ], "variable": [ { "key": "endpointId", "value": "" } ] } } } ] } ] }