Guides: API changelog
API changelog
Every change to the Motorbay API that you can see, newest first.
How we version the API
The major version is in the URL: /v1. Within /v1, changes only add things: new endpoints, fields, parameters, enum values and error codes. A breaking change comes as a new version, such as /v2. We announce it here at least 30 days ahead, as the terms promise. The old version keeps running for at least six months after its successor ships. Deprecated endpoints and fields are marked deprecated in the API reference.
6 Nov 2026
- Field names in four descriptions. Four descriptions named another field in C#, with its type, where the field's JSON name was meant:
ratinginenergyClassread "…; EnergyClassReasonResponse EnergyClassResponse.Reason says which." They now name the field: "…;reasonsays which." The others arecategoryinlicenceCategory,yearinmodelYearFromVinanddueByinestimatedNextInspection. Only the descriptions change: no field, value or shape.
2 Nov 2026
- The manufacturer's model year from the VIN on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, havemodelYearFromVin: the model year the VIN's year code at position 10 gives, next to the register'smodelYear, which is never changed.yearis read only when the check digit at position 9 is right and the year lies within a year offirstRegisteredOn, and isnullotherwise, with areason. Many EU VINs carry no year there, so European vehicles often get none.statussays how the register'smodelYearcompares:matches,differs,registerImplausible,fillsMissingorunknown.sourceslinks to 49 CFR 565.15 and Regulation (EU) 2021/535. Search, filters and statistics keep using the register'smodelYear, and the fields already on/calculatedare unchanged.
31 Oct 2026
- A chunked batch body over 64 KB is a
413, as one with a length is.POST /v1/vehicles/platesalready answered a body over 64 KB with413and the codePayloadTooLargewhen it said its length. Sent chunked, without a length, it was cut off while it was read and answered500. It is now a413 PayloadTooLargetoo, and like any answer that isn't2xxit costs nothing. Sent chunked, the key and the quota are checked before the413, so a bad key is still a401and an account with nothing left a429. The API reference lists the413for this endpoint. - The register's estimated consumption, as recorded. On
/v1/vehicles/{vehicleId}/fuel-types, and the vehicle lookups'fuelTypes,efficiencyTestProcedurecan now have id0, withoriginalNameINGEN (Forbrug beregnes ud fra vægt)and, withAccept-Language: en,nameNone (consumption estimated from weight): the register estimated that row'skilometersPerLiterandco2Emissionfrom the vehicle's weight, not measured them. Until now such a row hadefficiencyTestProcedurenull, as if the procedure wasn't recorded. Id 0 is a real procedure, so test fornull, not for a falsy id. The values themselves don't change. About 59,500 fuel rows had it in the 25 Oct extract. With it,/calculatedcan now answer the two reasons of 31 Oct,fuelConsumptionEstimatedByRegisterandconsumptionEstimatedByRegister, for the vehicles the register estimated. Both start with the next weekly import after this release. - An estimated consumption in the periodic taxes. On
/calculated,periodicTaxes.reasoncan now befuelConsumptionEstimatedByRegister: the register estimated the km/l on the primary fuel row from the vehicle's weight (test procedure INGEN, id 0). The tax is by that km/l, as the register records it, sobasisValueis the register's estimate. It can differ from an estimate from today's own weight, which staysfuelConsumptionFromOwnWeight. The amounts don't change. Only the reason is new. - An estimated consumption in the energy class. On
/calculated,energyClass.reasoncan now beconsumptionEstimatedByRegister: the register estimated the vehicle's km/l from its weight (test procedure INGEN, id 0), and no measured value is recorded. No energy labelling order classes an estimate, so such a vehicle still has no class. Only the reason is new. - Vehicle history goes back to 20 Sep 2026, and its oldest plate is a state, not a change. We have added the weekly extracts from 20 Sep to 11 Oct 2026 to the history, so
observedSinceis now 20 Sep 2026 for a vehicle in the register then, later for one that came into it after. The guides said history starts on 18 Oct 2026, which is no longer true. The oldest item in each list is what the vehicle had in the first extract we hold, not necessarily a change in the week before it. The description of a plate'sobservedOnsaid the plate changed in the week before it, which isn't true of the oldest plate: now it says the oldest may have changed at any time before, as a block's already did. Only descriptions change: no field, value or shape. See Data source and freshness.
30 Oct 2026
- Watches and webhooks. Watch a vehicle with
PUT /v1/watches/vehicles/{vehicleId}, and register an https endpoint withPOST /v1/webhooks/endpoints. After each weekly import, every watched vehicle that changed gets onePOSTto each of your endpoints, signed the Standard Webhooks way, with that week's plates, statuses, registration statuses and inspections. Failed deliveries are retried for about 35 hours, and an endpoint that answers410is turned off. The calls are free: they count toward the per-minute limit, not toward your plan. They need a paid plan: Starter watches 150 vehicles, Pro 1,000, Business and Enterprise 5,000, each with up to 5 endpoints. Nine operations are new:GET /v1/watches/vehicles,GET,PUTandDELETEon/v1/watches/vehicles/{vehicleId},GETandPOSTon/v1/webhooks/endpoints,GETandDELETEon/v1/webhooks/endpoints/{endpointId}, andPOST /v1/webhooks/endpoints/{endpointId}/rotate-secret. See Watches and webhooks. - New error codes.
PlanUpgradeRequired(403),WatchLimitReachedandEndpointLimitReached(409, withlimit),WebhookUrlNotAllowed(400), andWatchNotFoundandWebhookEndpointNotFound(404). Two new rules can appear in aValidationFailed:UrlRequiredandDescriptionTooLong. See Errors. - Calculated values ignore an implausible recorded value. Motorstyrelsen's extract has values no vehicle of its kind can have, such as an engine recorded in W instead of kW or a car at 2,281 km/l.
/calculatedand the statistics averages now read every such value as not recorded, from one table of ranges by kind.horsepowerandpowerToWeightarenullfor a power outside 1 to 1,000 kW on a car or van (1 to 400 on a motorcycle, 0.1 to 8 on a moped, 0.1 to 2,000 on other kinds).licenceCategoryanswerspowerUnknownordisplacementUnknownfor a motorcycle with an implausible power or displacement.periodicTaxesandenergyClassanswerconsumptionUnknownfor a positive km/l outside 1 to 60 on a petrol or diesel car or van that isn't a plug-in hybrid,periodicTaxesalso for a Wh/km outside 50 to 1,000, andco2Unknownfor CO2 over 1,000 g/km. A km/l of 0 or below still counts as not recorded, so the own weight estimate applies as before. That changes 85 tax answers in the 20 Oct extract, each from an amount to unknown. The statisticsmaximumPoweraverage for cars and vans now uses 1 to 1,000 kW instead of 5 to 1,500, so it takes in cars at 1 to 5 kW and leaves out those above 1,000. The vehicle resources still serve each value as Motorstyrelsen records it.
24 Oct 2026
- Energy class on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, haveenergyClass: the energy class,A+++toG, of a petrol or diesel passenger car or van, read from its recorded fuel consumption with the Danish energy labelling order in force on the day it was first registered.ratingis the class,reasonsays what decided it,kilometersPerLiteris the consumption it was read from, rounded to one decimal as the order says, andsourceslinks to the order applied. Cars first registered before 15 Apr 2000 and vans before 1 Jan 2010 had no label, and the classes aboveAstart on 1 Aug 2012. From 1 Jan 2019 the WLTP value is read with the WLTP table. A class is only given when the register records the test procedure of the value it reads, so many older vehicles have none, andreasonistestProcedureUnknown. Plug-in hybrids, electric and gas vehicles have no class, and other fuels areotherFuel, since the tables class petrol and diesel only. For a used import, the register's first registration can be the Danish date, so the order applied can be a later one. Calculated by Motorbay, not taken from the extract. The fields already on/calculatedare unchanged. - Blocks and leasing periods in vehicle history.
GET /v1/vehicles/{vehicleId}/history, andinclude=history, haveblocksandleasingPeriods: each set of blocks or leasing periods the vehicle had, newest first, the whole set each time it changed and an empty set when none was left. Each item hasobservedOn,changedOn(alwaysnull: the extract gives no date for these changes) and eitherblockingReasons, the same items as/blocking-reasons, orperiods, the same items as/leasing-periods. They started after the other lists, so they have their own start dates,blocksObservedSinceandleasingPeriodsObservedSince, the same for every vehicle, and the first set in each list is what the vehicle had then. Both arenull, and the lists empty, until we record that first set shortly after this release. The four other lists andobservedSinceare unchanged, so a client that only reads them needs no change. See Data source and freshness. - What a particle filter means for the environmental zones. The descriptions of
environmentalZoneson/calculatedand ofhasParticleFilteron/environmental-informationnow say what the filter is: a particle filter registered in the Motor Register, factory fitted or retrofitted and recorded at an inspection. That is what the zones check, so a registered filter passes whatever the Euro norm, and a filter that is fitted but not registered doesn't count.hasParticleFilterisfalsewhen none is registered, also when the register leaves the field out. Only the descriptions change: every answer stays the same. - Estimated next inspection on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, haveestimatedNextInspection: an estimate of the last day to present the vehicle for its next periodic inspection, from its kind, use, permits, first registration and latest inspection, with the inspection rules in force on that day.dueByis the day,statusisupcoming,overdue,notRequiredorunknownon the Danish day of the request,reasonsays what decided it,rulenames the cycle andsourceslinks to the act and the order. Cars and vans are due 4 years after first registration and then every 2 years, trucks, buses, taxis and heavy trailers every year, and vehicles registered for veteran use at the latest after 35 years and then every 8. A deadline from 1 Jan 2027 follows the rules that apply then, andnotessays so. The extract holds only the latest inspection, so a vehicle with none on record isoverduefor 15 weeks after its first deadline and thenunknown.overdueis as of the latest extract: an inspection done since then isn't in it yet. It is an estimate: Færdselsstyrelsen's summons sets the deadline, and a postponement isn't in the extract. The fields already on/calculatedare unchanged.
23 Oct 2026
- Averages, body types and first registration dates in statistics.
GET /v1/statistics/vehiclestakesaverage, one or more ofodometerReading,maximumPower,ownWeightandtotalWeight. The answer and every group then haveaverages, each{ "value", "unit", "basedOn" }: the mean with one decimal, its unit, and how many vehicles it is over. A value outside its kind's plausible range, such as an own weight of 555,555,555,555,555,555 kg, is left out rather than clipped. The ranges are in the guide.groupByalso takesbodyType,firstRegisteredYearandfirstRegisteredMonth(YYYY-MM, the month offirstRegisteredOn). An unknown or repeated metric is a400withAverageInvalid. Withoutaveragethe answer is as before. See Vehicle statistics. - Periodic taxes on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, haveperiodicTaxes: the periodic taxes on a passenger car, van or motorcycle for a tax period starting today, at that year's rates. Each oflinesis one tax or supplement, such asconsumptionTax,co2Tax,weightTax,equalisationTaxorparticleSupplement, with itsamount, itsperiodMonths,perYearand asourcelink to the act that sets it, andtotalPerYearadds them up. Cars first registered from 1 Jul 1997 and vans up to 3,500 kg from 18 Mar 2009 pay green ownership tax by km/l, or by g CO2/km from 1 Jul 2021, and older cars, motorcycles and older or heavier vans pay weight tax. The km/l is the one the register records on the primary fuel row, andreasonsays what decided it.notIncludednames what the register can't tell, such as the private-use supplement for vans and exemptions. Buses, trucks and trailers arenotCoveredfor now, and when the register lacks what a rule needs, such as for a plug-in hybrid first registered before 1 Jul 2021,statusisunknownwith the reason. Calculated by Motorbay, not Motorstyrelsen's bill. The fields already on/calculatedare unchanged.
17 Oct 2026
- Vehicle history.
GET /v1/vehicles/{vehicleId}/history, andinclude=historyon the vehicle lookups (so alsoinclude=all), return what changed about a vehicle from one weekly extract to the next:plates,statuses,registrationStatusesandinspectionswith their odometer readings, each newest first. Each item hasobservedOn, the day of the extract it was first seen in, andchangedOn, the day the register gives for the change, when it gives one.observedSinceis the earliest extract we hold for the vehicle. History starts with the extract of 18 Oct 2026, so until then the lists are empty andobservedSinceisnull. A vehicle that doesn't exist is a404withVehicleNotFound.units=imperialaddsconvertedto each inspection. One call is one request, on every plan. See Data source and freshness. - Environmental zones on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, haveenvironmentalZones: whether the vehicle may drive in the Danish environmental zones (København, Frederiksberg, Aarhus, Aalborg and Odense).statusisallowed,notAllowed,notAffectedorunknown,reasonsays what decided it, such aseuroNorm,particleFilterorfirstRegistration, andsourceslinks to the law applied. The zones regulate diesel only: a car or minibus needs Euro 5 or a registered particle filter, a van also passes when first registered on 1 Sep 2016 or later, and a truck or bus over 3,500 kg needs Euro VI, a filter or a first registration on 1 Jan 2015 or later. A vehicle registered for veteran use is exempt. Many diesel vehicles have no Euro norm in the register: a car, minibus or van first registered on 1 Jan 2014 or later is then taken as Euro 5, which EU rules required of new vehicles by then, andreasoniseuroNormFromFirstRegistration. A recorded norm always wins. For a used import, the register's first registration can be the Danish date, which can make an older vehicle look newer, both when it is taken as Euro 5 and for the van and heavy-vehicle dates. When the register lacks what a rule needs,statusisunknownandreasonsays what is missing. Dispensations aren't in the register, so a vehicle with one still reads asnotAllowed. Calculated by Motorbay, not taken from the extract. The fields already on/calculatedare unchanged. - The driving licence a vehicle needs, on
/calculated.GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, havelicenceCategory: the lowest Danish driving licence category that covers the vehicle driven on its own, without a trailer.categoryisB,C1,C,D1,D,A1,A2,A,AM,smallMopedortractorOrMotorTool,reasonsays what decided it,noteslists conditions the register can't check, andsourceslinks to the driving licence order. A car, van or truck up to 3,500 kg with at most 8 passengers isB, up to 7,500 kgC1, and above thatC. More than 8 passengers isD1up to 16 andDabove. The register has no length, soD1comes with the noted1OnlyUpTo8Metres. A motorcycle isA1,A2orAby power, displacement and power to weight. When the register lacks what decides it,categoryisnullandreasonsays what is missing, as it does for a trailer. Calculated by Motorbay, not taken from the extract. - English lookup names in US English, and buses called buses. With
Accept-Language: en, nine names change:GasolineforBenzin(wasPetrol),BusforStor personbil(wasLarge passenger car),Travel trailerforCampingvogn(wasCaravan),Goods transport (½ OMS.)for usage 38 (wasGoods transport (half VAT), a guess at the abbreviation),Van bought before 18 Mar 2009for permit type 104 (wastraded),Dealer plates not allowedfor permit type 76 (wasTrade plates),For-hire truckingfor permit type 9 (wasHaulage for hire), andhitch ballfortow ballin permit types 21 and 22. Onlynamechanges. Ids and the DanishoriginalNamestay the same, so match on the id.
16 Oct 2026
- EU Safety Gate recalls for a vehicle.
GET /v1/vehicles/{vehicleId}/recalls,/v1/vehicles/plate/{plate}/recallsand/v1/vehicles/vin/{vin}/recallsreturn the EU Safety Gate motor vehicle alerts (recalls and other measures published by EU and EEA authorities) that may cover the vehicle. They are matched on its EU type approval number and production dates, not on the VIN, and each alert'smatchedOnsays how:typeApprovalwhen the number and its extension match,typeApprovalBasewhen the alert or the register has no extension to compare. 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.canMatchsays whether this one can, and an emptyalertsmeans no matching alert was found, not that the vehicle has no recall. The alerts are in English as published and are refreshed weekly. Showsource.attributionwherever you show them: the European Commission requires it. A call counts as one request, like/check./checkitself is unchanged.
14 Oct 2026
- Two more things a Free
429can say. An account that hasn't verified a card or phone number may have only starter lookups, once for the life of the account. When they are used, the429with the codeQuotaExceededalso hasverificationRequired: trueandverifyUrl, the console page where you verify, and noRetry-After. The Free plan can also have a capacity for each day, shared by all Free accounts. When it is used, Free requests get a429with a new code,FreeCapacityExhausted, andRetry-Afterruns to 00:00 UTC. Neither applies to paid plans, and neither is switched on yet. A client that only checks the429status needs no change. One that branches oncodeshould handleFreeCapacityExhaustedas "wait until tomorrow". See Rate limits and quotas. - Errors in Danish. Send
Accept-Language: daand an error'stitleanddetailare in Danish. Without the header, or with any language other than Danish, they are in English, word for word as before, except that theDatasetNotLoadedtitle lost its final period like the other titles.Content-Languagesays which language was used. Thecode, the HTTP status and the keys inerrorsare the same in both languages, so branch on those, not on the text. The messages insideerrorsare still in English. A browser sendsAccept-Languageby itself, so a browser app now gets Danish text for users who prefer Danish. - A
405has a title. A method a path doesn't take, such asDELETE /v1/colors, answeredtitleMethodNotAllowed, the same as itscode. It now saysMethod not allowed, orMetoden er ikke tilladtin Danish. - Lookup names in English. Send
Accept-Language: enand thenameof a kind, color, usage, fuel type, emission standard, equipment, blocking reason, permit type or efficiency test procedure is in English, for exampleGrayforGråandPetrolforBenzin. That holds on their own endpoints and wherever a vehicle, search result, statistics group or sub-endpoint embeds them. Without the header, or when Danish is preferred,nameis Motorstyrelsen's Danish, as before.originalNameandidnever change, and makes, models, variants and designation types are proper names and stay as they are. A code Motorstyrelsen adds before we have translated it keeps its Danish name in both languages. Every answer now saysVary: Accept-Language. - Statistics in percent. Every group from
GET /v1/statistics/vehicleshasshare, its percent oftotalwith two decimals, for example12.11. With twogroupByfields a group also hasshareOfParent, its percent of the vehicles with the same first field:groupBy=make,fuelTypegives each make's fuel mix. Both come from the same exact counts ascount, andshareOfParentcounts every group, also those pastlimit. - Imperial units and horsepower on request. The vehicle parts with a measured value (
/engine,/technical-details,/environmental-information,/inspectionand/fuel-types) and the vehicle lookups, for the partsincludeadds, takeunits,powerandmpg.units=imperialaddsconvertedto each of those parts, with every measured field as{ "value", "unit" }: weights inlb, track widths and wheelbase inin, displacement inin3, top speed inmph, the odometer inthousandMi, fuel efficiency inmpgUs(ormpgUkwithmpg=uk), CO₂ ingPerMi, electric consumption inwhPerMiand emissions inmgPerMi.power=hpgives the power in mechanical horsepower (745.7 W, so 100 kW is 134.1 hp), with either system. That is not the metric horsepower (hk, 735.5 W) thathorsepoweron/calculatedgives, which is 136 for the same engine. Converted values are rounded to 1 decimal (emissions to 2) and are calculated by Motorbay, not taken from the extract. The raw fields never change: they stay in Motorstyrelsen's units. Without these parameters, or withunits=metric, the answer is the same as before, byte for byte, with noconverted. A value we don't accept, ormpgwithoutunits=imperial, is a400with the codeValidationFailedandUnitsInvalidinerrors. See Units. - The console's error messages in Danish. On a Danish page, the messages from sign-up, sign-in and your account are in Danish too. That covers a password that is too short, a wrong password or 2FA code, changed terms and an email address that can't be used. The console sends the page's language in
Accept-Language, and the answer says which language it used inContent-Language. WithoutAccept-Language: dathe messages are in English, word for word as before. The codes are the same in both languages.
11 Oct 2026
GET /v1/usageis taggedAccount. In the API reference and the OpenAPI document it was listed underData.WebApi. The endpoint itself is unchanged.- Search by fuel type and first registration date.
GET /v1/vehiclestakesfuelTypeId, a fuel type fromGET /v1/fuel-types, and matches vehicles with that primary fuel: the oneGET /v1/vehicles/{id}/fuel-typeslists first, withisPrimarytrue. It also takesfromFirstRegisteredOnandtoFirstRegisteredOnasYYYY-MM-DD, both days included, compared with a vehicle'sfirstRegisteredOn. Vehicles without the value are left out. A date that isn'tYYYY-MM-DDis a400with the codeValidationFailedandFirstRegisteredOnInvalidinerrors.GET /v1/statistics/vehiclestakesfuelTypeIdtoo. - A flag for impossible model years.
GET /v1/vehicles/{vehicleId}/calculated, andinclude=calculated, havemodelYearPlausible:falsewhen the register'smodelYearis after the extract's year plus one or before 1885,trueotherwise, andnullwithout a model year.modelYearis still served as Motorstyrelsen records it, and its description in the API reference now says so. - Statistics by fuel type.
GET /v1/statistics/vehiclestakesfuelTypeingroupBy, alone or with one other field:groupBy=make,fuelTypecounts each make per fuel. A group'sfuelTypeis the primary fuel, the same onefuelTypeIdfilters on, with its name. Vehicles without a primary fuel are a group withfuelType: null. - The statistics group schema matches the answers. A group has only the fields it is grouped by, and
count, as it always had. The OpenAPI document listed every grouping field as required, so a client generated from it could reject a real answer. Onlycountis required now. The answers are unchanged. - A parameter that isn't a number says which one.
makeId=abc,page=abcor/v1/colors/abcwas a400withValidationFailedand noerrors, so the answer didn't say what to fix. It is still a400withValidationFailed, anderrorsnow hasParameterInvalidwith a message naming the parameter.
10 Oct 2026
- A clearer
402. Every account has a plan now, so402with the codePaymentRequiredno longer means that you have no plan. It means the paid subscription is in a state we can't confirm, for example past due or canceled. Only the description in the API reference changed. - Look up many plates in one call.
POST /v1/vehicles/platestakes{"plates": ["AB12345", "cd 67-890"]}with 1 to 500 plates and answers{"results": [...]}with one item per plate, in the order you sent them. Each plate is read the same way asGET /v1/vehicles/plate/{plate}, and a plate on several vehicles gives the same vehicle as that endpoint. An item hasplate(as you sent it),normalizedPlate,found, and eithervehicle(the same object as the single lookup) orerror.error.codeisVehicleNotFoundfor a valid plate no vehicle has in the extract we loaded, orInvalidPlatewith amessagefor a plate that isn't valid. An invalid plate does not fail the call. A body that isn't an array of 1 to 500 strings is a400with the codeValidationFailed, and a body over 64 KB is a413with the codePayloadTooLarge. - What a batch costs. The call counts as one request per distinct valid plate against your monthly quota, checked for all of them before any lookup. A plate sent twice, or spelled two ways (
ab12345andAB-12345), counts once, and an invalid plate counts nothing. A call with no valid plate counts as one request. If your account can't cover them all, the whole call is a429with the codeQuotaExceeded, with no results and nothing counted. For the limit of 60 requests a minute per key, the whole call is one request. - Values Motorbay calculates.
GET /v1/vehicles/{vehicleId}/calculatedreturnshorsepower(hk),agein years and months withageUntil,annualKilometers,powerToWeight,isElectric,isPluginHybrid,manufacturerRegionandmanufacturerCountry(from the VIN, per ISO 3780), andcalculatedOn. They are calculated by Motorbay, not taken from the extract, and the raw values are unchanged. Each field in the API reference says how it is calculated. A vehicle that doesn't exist is a404with the codeVehicleNotFound. - A vehicle and its parts in one call.
GET /v1/vehicles/{id},GET /v1/vehicles/plate/{plate}andGET /v1/vehicles/vin/{vin}takeinclude, comma-separated (include=engine,inspection) or repeated (include=engine&include=inspection). The values aretechnicalDetails,engine,environmentalInformation,inspection,fuelTypes,equipment,secondaryUsages,blockingReasons,permits,leasingPeriods,check,calculated, orall. Each adds a property of the same name holding what its own endpoint returns: the object (nullwhere that endpoint answers204), or every item of the list, without paging. Withoutincludethe answer is unchanged. An unknown value is a400with the codeValidationFailedandIncludeInvalidinerrorsnaming it. The call counts as one request. - One lookup for a plate or a VIN.
GET /v1/vehicles/lookup/{plateOrVin}reads a value of exactly 17 letters and digits without I, O or Q as a VIN, and anything else as a registration number. It answers exactly what/v1/vehicles/vin/{vin}or/v1/vehicles/plate/{plate}answers, including404with the codeVehicleNotFound, and takesincludetoo. - Only answered requests count toward your plan. An answer that isn't
2xx, such as a404,400,413or5xx, no longer counts toward your month. The plan is still checked before the request runs, and the request is given back after. The limit of 60 requests a minute per key still counts every request. - A batch costs the plates it found.
POST /v1/vehicles/platesis checked for every distinct valid plate before any lookup, as before, and the plates no vehicle has are given back after. - Your month in one call.
GET /v1/usageanswersperiodStartandperiodResetsOn(YYYY-MM-DD, UTC),requestsfor the whole account this month,includedRequests,hardLimitandremaining(bothnullon a plan with no cap),planName,planType, andkeyRequestsfor the key you sent. It is free: it does not count toward your plan, and it counts toward the per-minute limit like any request. - Quota emails. We email you once when the month passes 80% of your plan's included requests, and once at 100%.
- Search by registration status.
GET /v1/vehiclestakesregistrationStatus:registered,deregistered,unknownorpending, spelled as a vehicle'sregistrationStatus. It combines with the other filters, andtotalCountstays exact. Any other value is a400with the codeRegistrationStatusInvalid. - Vehicle statistics.
GET /v1/statistics/vehiclestakes the same filters as vehicle search and answers{"total": n, "groupCount": n, "groups": [...]}. WithgroupBy, one or two ofmake,kind,usage,color,modelYearandregistrationStatus, each group has the grouped fields and itscount, largest first, at mostlimitof them (default 50, max 1000). Makes, kinds, usages and colors come with their names. The counts describe the weekly extract we loaded, asMotorbay-Data-As-Ofsays, and one call is one request. A badgroupByis a400withGroupByInvalid, three or more fieldsGroupByTooMany, and alimitout of rangeLimitOutOfRange. See Vehicle statistics.
9 Oct 2026
- Used-car check.
GET /v1/vehicles/{vehicleId}/check,GET /v1/vehicles/plate/{plate}/checkandGET /v1/vehicles/vin/{vin}/checkreturn the risk signals for a used vehicle in one answer:statusandregistrationStatuswith their dates,blocks,hasTrafficDamage,hasRestampedVinandvinRestampedAt,activeLeasingPeriod,latestInspection(result, day and odometer reading),registrationNumberExpiresOn, andflags, each with acode(such astotalLossoractiveLeasing), aseverity(high,mediumorinfo) and a plain Englishlabel, most severe first. A leasing period is active when it coverscheckedOn, the Danish calendar day of the request, both ends included. The check reflects the latest weekly extract we loaded, so a vehicle with no flags is not a guarantee. An unknown vehicle is a404with the codeVehicleNotFound. - Blocks per vehicle.
GET /v1/vehicles/{vehicleId}/blocking-reasonslists the blocks registered on a vehicle in the latest extract we loaded, in id order. Each item hasid,nameandoriginalName, such as"3","Totalskadet køretøj". It is a paginated list like/equipment: an unblocked vehicle is a200with"data": [], and an unknown vehicle is a404with the codeVehicleNotFound. A block we can't yet describe precisely is shown as the general block"0","Køretøjet er blokeret", and the general block is listed once. - Blocking reasons as reference data.
GET /v1/blocking-reasonsandGET /v1/blocking-reasons/{id}list and get blocking reasons, the same way as colors and kinds. An unknown blocking reason is a404with the codeBlockingReasonNotFound. - Permits per vehicle.
GET /v1/vehicles/{vehicleId}/permitslists the permits registered on a vehicle, newest first, such as"Stelnummer Genihugget"(a re-stamped VIN) or a trailer coupling. Each item hasvalidFromAt(an instant in UTC),typeas{ "id", "name", "originalName" },fixedConnectionandvariableCombination. Permit comments are not included: they can hold personal data.GET /v1/permit-typesandGET /v1/permit-types/{id}list and get permit types. An unknown permit type is a404with the codePermitTypeNotFound. - Leasing periods per vehicle.
GET /v1/vehicles/{vehicleId}/leasing-periodslists a vehicle's leasing periods, newest start first, withvalidFromOnandvalidUntilOnasYYYY-MM-DD.validUntilOnisnullfor an open-ended period.
8 Oct 2026
- Fuel types and consumption per vehicle.
GET /v1/vehicles/{vehicleId}/fuel-typeslists the fuels a vehicle runs on, primary first. Each item hasfuelTypeas{ "id", "name", "originalName" },isPrimary,kilometersPerLiter,co2Emission(g/km),electricConsumption(Wh/km),hasFuelCellandefficiencyTestProcedure(such as WLTP, ornull). It is a paginated list like/equipment: a vehicle with no fuel recorded is a200with"data": [], and an unknown vehicle is a404with the codeVehicleNotFound. - Fuel types as reference data.
GET /v1/fuel-typesandGET /v1/fuel-types/{id}list and get fuel types, the same way as colors and kinds. An unknown fuel type is a404with the codeFuelTypeNotFound.
7 Oct 2026
- Model year has its own index. A search with
fromModelYearortoModelYearthat matched few vehicles, such astoModelYear=1990, could run for 30 seconds and fail with a 500. With the index, several such searches answer in under 2 seconds. Others, such astoModelYear=2000, still timed out until the next change. - Searches that match few vehicles answer in seconds. A search that matched up to 100,000 vehicles could still run for 30 seconds and fail with a 500 when those vehicles came last in the sort order, such as
toModelYear=2000. Such a search now gets 2 seconds to answer the usual way, and after that its page is read by sorting only the vehicles that match. The searches of that kind we measured answer in about 2 to 5 seconds, and up to 15 seconds the first time a search is run, while its data is read from disk. The page andtotalCountare the same either way. A search that matches more than 100,000 vehicles is read as before, and some of those can still take up to 30 seconds or fail, such as a wide range of model years (fromModelYear=2015&toModelYear=2020). - Repeated requests answer from memory. The API now keeps each answer for up to a day, and never past the next weekly import, so asking for the same vehicle, search page or list again doesn't go to the database. The answer is the same, it still counts as a request toward your rate limit and plan, and
Motorbay-Data-As-Ofstill says which extract it came from. After an import, the API answers from the new extract within 5 minutes, as it did before.
6 Oct 2026
- Broad vehicle searches are much faster. A search that matched millions of vehicles, such as one with no filter or
kindIdfor passenger cars, took 15 to 20 seconds, becausetotalCountwas counted vehicle by vehicle. It now comes from counts the import keeps per combination of the search filters, and such a search typically answers in under a second.totalCountis still exact, and nothing in the response changed.
5 Oct 2026
- Vehicles come with names. A vehicle now includes what it references, with its name:
kind,make,model,variant,designationType,color,emissionStandardandprimaryUsage, each as{ "id", "name", "originalName" }, the same fields the reference endpoints return. You no longer need a call to/v1/colors/{id}or/v1/makes/{id}to show "Grå" or "VOLKSWAGEN". This applies to/v1/vehicles/{id},/v1/vehicles/vin/{vin},/v1/vehicles/plate/{plate}and vehicle search. The…Idfields stay as they were. A reference the vehicle doesn't have isnull.variantanddesignationTypecan also benullwhilevariantIdordesignationTypeIdis set: Motorstyrelsen keeps them per model, and a vehicle without a model has none we can name. - Equipment and secondary usages come with names.
GET /v1/vehicles/{vehicleId}/equipmentandGET /v1/vehicles/{vehicleId}/secondary-usagesincludenameandoriginalNamefor each item, next to itsid.
28 Sep 2026
- Timestamps are in UTC. Every timestamp, meaning fields ending in
AtandimportedAton/v1/dataset, is sent in UTC with aZ, for example2026-09-18T08:43:12.345Z. Before, some carried+02:00. The instant is the same. - Reference data names are Motorstyrelsen's text. The
namefield on reference data is Motorstyrelsen's Danish text, the same asoriginalName.
26 Sep 2026
- 503 when your key can't be checked. When your API key can't be checked for a moment, the API answers
503with the codeServiceUnavailableand aRetry-Afterheader, not401. Your key is fine: retry after the given number of seconds. HEAD /health/data.GET /health/dataalso answersHEAD, for uptime monitors that only sendHEAD.
25 Sep 2026
- Plate lookup normalizes its input.
GET /v1/vehicles/plate/{plate}trims, uppercases and removes spaces and hyphens, soab 12 345findsAB12345. Input with characters other than A to Z, 0 to 9, Æ, Ø and Å, or longer than 10, is a400with the new rule codeRegistrationNumberInvalid. - Plate lookup picks the right vehicle. When several vehicles have had a registration number, the lookup returns the one currently registered with it, or else the most recent one. The answer no longer changes between requests.
- Search by registration number.
GET /v1/vehicles?registrationNumber=lists every vehicle that has had a registration number, in the order the lookup picks from.
24 Sep 2026
The first version of the API, /v1.
- Vehicles by ID, VIN and registration number, with their technical details, engine, environmental information, inspection, equipment and secondary usages.
- Vehicle search with filters on make, kind, usage, color and model year, sorting with
sortBy, and at most 10,000 results per search. - Reference data: makes, models, variants, designation types, colors, kinds, usages, emission standards and equipment.
GET /v1/datasetand theMotorbay-Data-As-Ofheader, to see how old the data is.- Authentication with the
X-Api-Keyheader. - Errors as problem details with a stable
code, and anX-Request-Idheader on every response. - 60 requests per minute per key.
Didn't find the answer? Email support@motorbay.app.