Vejledninger: Datakilde og aktualitet
Datakilde og aktualitet
Hvad Motorbay API'et leverer, hvor det kommer fra, og hvordan du ser, hvor gamle data er.
Kilden
Data kommer fra Motorstyrelsens ugentlige offentlige statistikudtræk af Det Digitale Motorregister (DMR). Motorbay er ikke tilknyttet Motorstyrelsen, og data leveres, som de er.
Vi importerer udtrækket, som det er registreret. Vi konverterer typer og normaliserer identifikatorer. Vi retter, gætter og udfylder ikke værdier.
Udtrækket indeholder ingen ejere, brugere eller andre personer, og det gør API'et heller ikke.
Det er ugentligt, ikke i realtid
Motorstyrelsen offentliggør et nyt udtræk cirka én gang om ugen. Vi importerer det, efter at det er offentliggjort. En ændring, der registreres hos Motorstyrelsen, når API'et efter deres næste udtræk og vores import, som regel inden for en uge. API'et er ikke i realtid.
Det forrige udtræk forbliver i drift, mens en import kører, så API'et holder ikke pause under importer.
Tjek, hvor gamle data er
GET /v1/dataset beskriver det udtræk, der leveres:
curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
"https://api.motorbay.app/v1/dataset"{
"sourcePublishedAt": "2026-09-21T04:43:39+00:00",
"importedAt": "2026-09-21T17:01:50.9719+00:00",
"vehicleCount": 4869,
"source": "Motorstyrelsen, weekly public statistics extract (ESStatistikListeModtag)"
}| Felt | Betydning |
|---|---|
sourcePublishedAt |
Hvornår Motorstyrelsen offentliggjorde udtrækket |
importedAt |
Hvornår vores import af det blev færdig og gik i drift |
vehicleCount |
Hvor mange køretøjer udtrækket indeholder. null for ældre importer |
source |
Hvor data kommer fra |
Før den første import er færdig, svarer det 503 med koden DatasetNotLoaded.
Alle svar på en forespørgsel med en gyldig nøgle har også headeren Motorbay-Data-As-Of med udtrækkets offentliggørelsestidspunkt, så du kan gemme det sammen med det, du gemmer:
Motorbay-Data-As-Of: 2026-09-21T04:43:39ZNår importedAt ændrer sig, er et nyt udtræk i drift. Det er et godt tidspunkt at opdatere det, du har gemt.
Sådan læser du data
- Id'er er tekststrenge. De indeholder Motorstyrelsens numeriske identifikatorer, fx
"9000000006320919". Behandl dem som uigennemsigtig tekst. Fortolk dem ikke som tal: de kan ikke alle være i et JavaScript-tal. - Kalenderdatoer er
YYYY-MM-DDuden tidszone, i felter, hvis navne ender påOn, fxfirstRegisteredOn. - Tidspunkter er ISO 8601 med UTC-forskydning, i felter, hvis navne ender på
At, fxstatusUpdatedAt. Forskydningen er ikke altidZ:/v1/datasetsender+00:00, og nogle køretøjsfelter sender+02:00. Læs forskydningen i stedet for at gå ud fra UTC. - Manglende værdier er
null, de udelades aldrig. Nogle felter har et flag somisMaximumPowerUnavailable, der ertrue, når registret markerer værdien som ikke indberettet. - Lister er aldrig
null. En tom liste er[]. - Tal beholder Motorstyrelsens enheder, fx kg, mm og kW. Hvert felts enhed står i API-referencen.
- Statusværdier er camelCase, fx
registeredogderegistered. Motorstyrelsen tilføjer værdier med tiden, så håndtér værdier, du ikke kender. - Referencedata har to navne. Arter, farver, anvendelser og andre referencedata har
nameogoriginalName.originalNameer altid Motorstyrelsens danske tekst, fxPersonbil.nameer den samme danske tekst, eller engelsk, når du senderAccept-Language: en, fxPassenger car. Mærker, modeller, varianter og typebetegnelser er egennavne og bliver aldrig oversat. - Værdier er som registreret. Vi giver det videre, som Motorstyrelsen har registreret det, og retter det ikke, så en værdi kan være forkert.
modelYearer en af dem: nogle få køretøjer har et modelår, der ikke kan passe, fx 2112 for en bil, der blev registreret første gang i 2012.modelYearPlausiblepå/calculatedmarkerer dem. Søgning og statistik filtrerer påmodelYear, som det er registreret. - Ignorér felter, du ikke kender. Vi tilføjer felter uden en ny API-version.
Alle køretøjer bliver i data
Afmeldte, ophuggede og eksporterede køretøjer bliver i data med deres status. Tjek registrationStatus og status, hvis du kun vil have køretøjer, der kører på vejene.
Værdier, Motorbay beregner
GET /v1/vehicles/{vehicleId}/calculated returnerer værdier, der ikke står i Motorstyrelsens udtræk. Motorbay beregner dem ud fra de rå værdier, som er uændrede på de andre køretøjsressourcer. En værdi er null, når de data, den bygger på, mangler. En registreret værdi, som intet køretøj af sin art kan have, regnes som manglende: en effekt uden for 1 til 1.000 kW for en personbil eller varebil (1 til 400 for en motorcykel, 0,1 til 8 for en knallert, 0,1 til 2.000 for andre arter), som en motor registreret i W, eller en km/l uden for 1 til 60 for en benzin- eller dieseldrevet personbil eller varebil, der ikke er plugin-hybrid. Det samme gælder en personbils eller varebils Wh/km uden for 50 til 1.000 eller CO2 over 1.000 g/km og en motorcykels slagvolumen over 3.000 cm³. En km/l eller Wh/km på 0 eller derunder er et felt, der ikke er udfyldt, så skønnet ud fra egenvægten gælder. CO2 har intet skøn: en negativ CO2 er ukendt, og det er 0 på en benzin- eller dieselbil også, mens en elbils 0 regnes som 0 g. Køretøjsressourcerne leverer stadig hver værdi, som Motorstyrelsen har registreret den.
horsepowerer hestekræfter (hk):maximumPoweri kW gange 1,35962, afrundet til et helt tal.ageer{ "years", "months" }frafirstRegisteredOntil dagens danske dato (calculatedOn). For et afmeldt køretøj tælles der til den dag, det blev afmeldt.ageUntilfortæller hvilken:todayellerderegistered.annualKilometerser kilometerstanden ved seneste syn (i km) delt med antal år fra første registrering til det syn. Den ernull, når synet lå mindre end et år efter første registrering.powerToWeighter kW pr. kgownWeightmed 3 decimaler.isElectricertrue, når El er den eneste drivkraft.isPluginHybridertrue, når der er registreret et brændstof med et elforbrug. Udtrækket registrerer de fleste plug-in-hybrider som én Benzin- eller Diesel-række med et elforbrug. Udtrækket kan ikke skelne en mild eller almindelig hybrid fra en benzin- eller dieselbil, så der er ingenisHybrid.modelYearPlausibleerfalse, nårmodelYearligger efter udtrækkets år plus ét, eller før 1885, året, hvor den første bil blev bygget. Den ertrueellers, også når modelåret er ældre endfirstRegisteredOn, hvilket et importeret eller sent registreret køretøj kan være. SelvemodelYearændres aldrig.modelYearFromViner fabrikantens modelår ud fra stelnummeret, ved siden af registretsmodelYear, som aldrig ændres.yearlæses af årskoden på plads 10, kun når kontrolcifret på plads 9 stemmer, og året ligger højst et år frafirstRegisteredOn, og er ellersnullmed enreason. EU-retten kræver ikke et år på plads 10, så mange europæiske køretøjer får intet, og det kan en sen import også.statusermatches,differs,registerImplausible(nårmodelYearPlausibleerfalse),fillsMissingellerunknown. En fabrikants modelår kan begynde i kalenderåret før, sådiffersbetyder ikke, at nogen af dem er forkert. Søgning, filtre og statistik bruger fortsat registretsmodelYear.manufacturerRegionogmanufacturerCountrykommer fra stelnummerets to første tegn og landetabellen i ISO 3780, fxeuropeogSE. Landet er der, hvor fabrikantkoden er tildelt, som regel der, hvor køretøjet er bygget. Vi navngiver ikke fabrikanten ud fra stelnummeret.periodicTaxeser den periodiske afgift på en personbil, varebil eller motorcykel for en afgiftsperiode, der begynder i dag, med årets satser: grøn ejerafgift efter km/l eller g CO2/km, eller vægtafgift, med udligningsafgiften og partikeltillægget.lineshar hvert beløb med sinperiodMonthsog den lov, det kommer fra. Km/l er den, der er registreret på den primære drivmiddelrække, og en WLTP-værdi ganges med 1,21, som loven siger.notIncludednævner, hvad udtrækket ikke kan vise, som fritagelser. Busser, lastbiler og påhængskøretøjer ernotCovered, ogstatuserunknownmed enreason, når udtrækket mangler det, reglen kræver. Det er ikke Motorstyrelsens opkrævning.energyClasser energiklassen,A+++tilG, for en benzin- eller dieseldrevet personbil eller varebil, læst ud fra dens registrerede km/l med den energimærkningsbekendtgørelse, der gjaldt den dag, den blev registreret første gang. Fra 1. jan. 2019 er det WLTP-skemaet, før det NEDC-skemaet, og klasserne overAbegynder 1. aug. 2012. Der gives kun en klasse, når registret har testmetoden for værdien, da en værdi uden en kan være beregnet ud fra vægten, så mange ældre køretøjer har ingen. Plugin-hybrider, elbiler og gasbiler har ingen klasse.estimatedNextInspectioner et skøn over den sidste dag, køretøjet skal fremstilles til sit næste periodiske syn (dueBy), ud fra art, anvendelse, tilladelser, første registrering og seneste syn, med de regler, der gælder den dag.statuserupcomingelleroverduepå dagens danske dato,notRequiredfor køretøjer, der ikke skal til periodisk syn eller er afmeldt, ellerunknown, når udtrækket mangler det, der afgør det.overduegælder ud fra det seneste udtræk, da et syn, der er sket efter det, ikke står i det endnu. Udtrækket har kun det seneste syn, så et køretøj uden noget syn eroverduei 15 uger efter sin første frist, hvor nummerpladerne inddrages, ogunknownderefter. Færdselsstyrelsens indkaldelse fastsætter den rigtige frist.
Køretøjets historik
GET /v1/vehicles/{vehicleId}/history, eller include=history på et opslag, viser, hvad der har ændret sig for et køretøj fra det ene ugentlige udtræk til det næste: registreringsnumre (plates), statuses, registrationStatuses og inspections, nyeste først.
- Historikken går tilbage til udtrækket fra 20. sep. 2026. Hvert udtræk har kun køretøjets tilstand den uge, så historikken er køretøjets tilstand i det første udtræk, vi har for det, og derefter det, vi har set ændre sig siden.
observedSinceer dagen for det udtræk: 20. sep. 2026 for et køretøj, der var i registret da, senere for et, der er kommet i det siden. Det ældste punkt i hver liste er det, køretøjet havde i det udtræk, ikke nødvendigvis en ændring i ugen før. En nummerplade eller et syn fra før den mangler ikke i registret: vi har bare intet udtræk fra dengang. Et køretøj uden historik endnu har tomme lister ogobservedSince: null. observedOner dagen for det udtræk, en værdi først blev set i.changedOner den dag, registret angiver for ændringen, når det angiver en. Nummerplader har ingen, så en nummerplade er skiftet i ugen før densobservedOn, eller, for den ældste nummerplade, når som helst før.- En nummerplade i
plateskan sidde på et andet køretøj nu. Registreringsnumre genbruges, og ønskeplader flytter mellem køretøjer.plate: nullbetyder, at pladerne er taget af. inspectionshar hvert nyt syn medodometerReadingi tusinder km. Det seneste står også på/inspection. Medunits=imperialhar hvert synconverted, som på/inspection.blocksogleasingPeriodshar hvert sæt blokeringer eller leasingperioder, køretøjet har haft, nyeste først: hele sættet, hver gang det ændrede sig, og et tomt sæt, når der ikke var flere. En blokering har navn som på/blocking-reasons, og en periode harvalidFromOnogvalidUntilOnsom på/leasing-periods. De to lister startede senere end de andre, så de har deres egne startdatoer,blocksObservedSinceogleasingPeriodsObservedSince, de samme for alle køretøjer. Det første sæt i hver liste er det, køretøjet havde den dag, ikke en ændring. Indtil da er begge datoernull, og listerne er tomme, hvilket ikke siger noget om køretøjet.- En uge, vi trækker tilbage, vises aldrig. Viser et udtræk sig at være forkert, og vi går tilbage til ugen før, forsvinder dets ændringer også fra historikken.
Et kald er én forespørgsel, på alle abonnementer.
Slå et køretøj op på registreringsnummer
GET /v1/vehicles/plate/{plate} slår et køretøj op på registreringsnummer. Registreringsnumre genbruges, og ønskeplader flytter mellem køretøjer, så flere køretøjer i registret kan have haft det samme.
- Input trimmes og skrives med store bogstaver, og mellemrum og bindestreger fjernes, så
ab 12 345ogAB-12345finderAB12345. - Kun A til Z, 0 til 9, Æ, Ø og Å accepteres, højst 10 af dem. Alt andet giver
400medRegistrationNumberInvalidundererrors. - Hvis flere køretøjer har haft registreringsnummeret, får du det, der er registreret med det nu. Er intet det, får du det seneste, og dets
registrationStatusfortæller, at det ikke længere er registreret. Svaret er det samme ved hver forespørgsel. GET /v1/vehicles?registrationNumber=AB12345viser alle køretøjer, der har haft det, i samme rækkefølge, så det første element er det, opslaget returnerer.
Fandt du ikke svaret? Skriv til support@motorbay.app.