Vejledninger: API-ændringslog
API-ændringslog
Alle ændringer i Motorbay API'et, som du kan se, nyeste først.
Sådan versionerer vi API'et
Hovedversionen står i URL'en: /v1. Inden for /v1 tilføjer ændringer kun: nye endpoints, felter, parametre, enum-værdier og fejlkoder. En ændring, der bryder klienter, kommer i en ny version, fx /v2. Vi annoncerer den her mindst 30 dage før, som vilkårene lover. Den gamle version kører videre i mindst seks måneder, efter den nye er kommet. Udfasede endpoints og felter er markeret deprecated i API-referencen.
6. nov. 2026
- Feltnavne i fire beskrivelser. Fire beskrivelser nævnte et andet felt i C# med dets type, hvor feltets JSON-navn var ment:
ratingienergyClasslød "…; EnergyClassReasonResponse EnergyClassResponse.Reason says which." Nu nævner de feltet: "…;reasonsays which." De andre ercategoryilicenceCategory,yearimodelYearFromVinogdueByiestimatedNextInspection. Kun beskrivelserne ændres: ingen felter, værdier eller former.
2. nov. 2026
- Fabrikantens modelår ud fra stelnummeret på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharmodelYearFromVin: det modelår, stelnummerets årskode på plads 10 giver, ved siden af registretsmodelYear, som aldrig ændres.yearlæses kun, når kontrolcifret på plads 9 stemmer, og året ligger højst et år frafirstRegisteredOn, og er ellersnullmed enreason. Mange EU-stelnumre har intet år der, så europæiske køretøjer får ofte intet.statusfortæller, hvordan registretsmodelYearpasser:matches,differs,registerImplausible,fillsMissingellerunknown.sourceslinker til 49 CFR 565.15 og forordning (EU) 2021/535. Søgning, filtre og statistik bruger fortsat registretsmodelYear, og felterne, der allerede er på/calculated, er uændrede.
31. okt. 2026
- En chunked batch-body over 64 KB er en
413, ligesom en med længde.POST /v1/vehicles/platessvarede allerede en body over 64 KB med413og kodenPayloadTooLarge, når den oplyste sin længde. Sendt chunked, uden længde, blev den afbrudt, mens den blev læst, og svaret var500. Nu er det også en413 PayloadTooLarge, og som ethvert svar, der ikke er2xx, koster det ingenting. Sendt chunked bliver nøglen og kvoten tjekket før413, så en ugyldig nøgle giver stadig401, og en konto uden flere opslag giver429. API-referencen viser413for dette endpoint. - Registrets anslåede forbrug, som det står. På
/v1/vehicles/{vehicleId}/fuel-typesog i køretøjsopslagenesfuelTypeskanefficiencyTestProcedurenu have id0, medoriginalNameINGEN (Forbrug beregnes ud fra vægt): registret har anslået rækkenskilometersPerLiterogco2Emissionud fra køretøjets vægt, ikke målt dem. Hidtil havde sådan en rækkeefficiencyTestProcedurenull, som om testmetoden ikke var registreret. Id 0 er en rigtig testmetode, så test fornull, ikke for et falsk id. Selve værdierne ændrer sig ikke. Omkring 59.500 drivmiddelrækker havde den i udtrækket fra 25. okt. Dermed kan/calculatednu svare med de to årsager fra 31. okt.,fuelConsumptionEstimatedByRegisterogconsumptionEstimatedByRegister, for de køretøjer registret har anslået. Begge starter med den næste ugentlige import efter denne udgivelse. - Et anslået forbrug i de periodiske afgifter. På
/calculatedkanperiodicTaxes.reasonnu værefuelConsumptionEstimatedByRegister: registret har anslået km/l på den primære drivmiddelrække ud fra køretøjets vægt (testmetode INGEN, id 0). Afgiften er efter den km/l, som registret har den, såbasisValueer registrets skøn. Den kan afvige fra et skøn ud fra dagens egenvægt, som stadig erfuelConsumptionFromOwnWeight. Beløbene ændrer sig ikke. Kun årsagen er ny. - Et anslået forbrug i energiklassen. På
/calculatedkanenergyClass.reasonnu væreconsumptionEstimatedByRegister: registret har anslået køretøjets km/l ud fra dets vægt (testmetode INGEN, id 0), og der er ingen målt værdi. Ingen energimærkningsbekendtgørelse klassificerer et skøn, så sådan et køretøj har stadig ingen klasse. Kun årsagen er ny. - Køretøjets historik går tilbage til 20. sep. 2026, og dens ældste nummerplade er en tilstand, ikke en ændring. Vi har føjet de ugentlige udtræk fra 20. sep. til 11. okt. 2026 til historikken, så
observedSincenu er 20. sep. 2026 for et køretøj, der var i registret da, senere for et, der er kommet i det siden. Guiderne sagde, at historikken starter 18. okt. 2026, og det passer ikke længere. Det ældste punkt i hver liste er det, køretøjet havde i det første udtræk, vi har, ikke nødvendigvis en ændring i ugen før. Beskrivelsen af en nummerpladesobservedOnsagde, at pladen er skiftet i ugen før, og det passer ikke for den ældste nummerplade: nu siger den, at den ældste kan være skiftet når som helst før, som en blokerings allerede gjorde. Kun beskrivelser ændrer sig: ingen felter, værdier eller former. Se Datakilde og aktualitet.
30. okt. 2026
- Overvågning og webhooks. Overvåg et køretøj med
PUT /v1/watches/vehicles/{vehicleId}, og registrer et https-endpoint medPOST /v1/webhooks/endpoints. Efter hver ugentlig import får hvert af dine endpoints étPOSTfor hvert overvåget køretøj, der har ændret sig, signeret efter Standard Webhooks, med ugens nummerplader, statusser, registreringsstatusser og syn. Leveringer, der fejler, prøves igen i omkring 35 timer, og et endpoint, der svarer410, slås fra. Kaldene er gratis: de tæller med i grænsen pr. minut, ikke i abonnementet. De kræver et betalt abonnement: Starter overvåger 150 køretøjer, Pro 1.000, Business og Enterprise 5.000, hver med op til 5 endpoints. Ni operationer er nye:GET /v1/watches/vehicles,GET,PUTogDELETEpå/v1/watches/vehicles/{vehicleId},GETogPOSTpå/v1/webhooks/endpoints,GETogDELETEpå/v1/webhooks/endpoints/{endpointId}ogPOST /v1/webhooks/endpoints/{endpointId}/rotate-secret. Se Overvågning og webhooks. - Nye fejlkoder.
PlanUpgradeRequired(403),WatchLimitReachedogEndpointLimitReached(409, medlimit),WebhookUrlNotAllowed(400) samtWatchNotFoundogWebhookEndpointNotFound(404). To nye regler kan stå i enValidationFailed:UrlRequiredogDescriptionTooLong. Se Fejl. - Beregnede værdier ser bort fra en usandsynlig registreret værdi. Motorstyrelsens udtræk har værdier, som intet køretøj af sin art kan have, som en motor registreret i W i stedet for kW eller en bil på 2.281 km/l.
/calculatedog gennemsnittene i statistikken læser nu hver sådan værdi som ikke registreret, ud fra én tabel med intervaller pr. art.horsepowerogpowerToWeighternullfor en effekt uden for 1 til 1.000 kW på en personbil eller varebil (1 til 400 på en motorcykel, 0,1 til 8 på en knallert, 0,1 til 2.000 på andre arter).licenceCategorysvarerpowerUnknownellerdisplacementUnknownfor en motorcykel med en usandsynlig effekt eller slagvolumen.periodicTaxesogenergyClasssvarerconsumptionUnknownfor en positiv km/l uden for 1 til 60 på en benzin- eller dieseldrevet personbil eller varebil, der ikke er plugin-hybrid,periodicTaxesogså for en Wh/km uden for 50 til 1.000, ogco2Unknownfor CO2 over 1.000 g/km. En km/l på 0 eller derunder regnes stadig som ikke registreret, så skønnet ud fra egenvægten gælder som før. Det ændrer 85 afgiftssvar i udtrækket fra 20. okt., hvert fra et beløb til ukendt. Gennemsnittet afmaximumPowerfor personbiler og varebiler bruger nu 1 til 1.000 kW i stedet for 5 til 1.500, så det tager biler på 1 til 5 kW med og udelader dem over 1.000. Køretøjsressourcerne leverer stadig hver værdi, som Motorstyrelsen har registreret den.
24. okt. 2026
- Energiklasse på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharenergyClass: energiklassen,A+++tilG, for en benzin- eller dieseldrevet personbil eller varebil, læst ud fra dens registrerede brændstofforbrug med den danske energimærkningsbekendtgørelse, der gjaldt den dag, den blev registreret første gang.ratinger klassen,reasonfortæller, hvad der afgjorde den,kilometersPerLiterer det forbrug, den blev læst ud fra, afrundet til én decimal, som bekendtgørelsen siger, ogsourceslinker til den bekendtgørelse, der er brugt. Personbiler første gang registreret før 15. apr. 2000 og varebiler før 1. jan. 2010 havde intet mærke, og klasserne overAbegynder 1. aug. 2012. Fra 1. jan. 2019 læses WLTP-værdien med WLTP-skemaet. Der gives kun en klasse, når registret har testmetoden for den værdi, der læses, så mange ældre køretøjer har ingen, ogreasonertestProcedureUnknown. Plugin-hybrider, elbiler og gasbiler har ingen klasse, og andre drivmidler erotherFuel, da skemaerne kun klassificerer benzin og diesel. For en brugt importbil kan registrets første registrering være den danske dato, så den bekendtgørelse, der bruges, kan være en senere. Beregnet af Motorbay, ikke taget fra udtrækket. Felterne, der allerede er på/calculated, er uændrede. - Blokeringer og leasingperioder i køretøjets historik.
GET /v1/vehicles/{vehicleId}/historyoginclude=historyharblocksogleasingPeriods: 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. Hvert punkt harobservedOn,changedOn(altidnull: udtrækket angiver ingen dato for disse ændringer) og entenblockingReasons, de samme punkter som/blocking-reasons, ellerperiods, de samme punkter som/leasing-periods. De startede efter de andre lister, så de har deres egne startdatoer,blocksObservedSinceogleasingPeriodsObservedSince, de samme for alle køretøjer, og det første sæt i hver liste er det, køretøjet havde dengang. Begge ernull, og listerne tomme, indtil vi registrerer det første sæt kort efter denne udgivelse. De fire andre lister ogobservedSinceer uændrede, så en klient, der kun læser dem, skal ikke ændres. Se Datakilde og aktualitet. - Hvad et partikelfilter betyder for miljøzonerne. Beskrivelserne af
environmentalZonespå/calculatedog afhasParticleFilterpå/environmental-informationsiger nu, hvad filteret er: et partikelfilter, der er registreret i Motorregistret, monteret fra fabrikken eller eftermonteret og registreret ved et syn. Det er det, miljøzonerne kontrollerer, så et registreret filter er godkendt uanset euronormen, og et filter, der er monteret, men ikke registreret, tæller ikke.hasParticleFiltererfalse, når der ikke er registreret et, også når registret udelader feltet. Kun beskrivelserne ændres: alle svar er de samme. - Anslået næste syn på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharestimatedNextInspection: et skøn over den sidste dag, køretøjet skal fremstilles til sit næste periodiske syn, ud fra art, anvendelse, tilladelser, første registrering og seneste syn, med de synsregler, der gælder den dag.dueByer dagen,statuserupcoming,overdue,notRequiredellerunknownpå den danske dag for forespørgslen,reasonfortæller, hvad der afgjorde det,rulenævner synsintervallet, ogsourceslinker til loven og bekendtgørelsen. Personbiler og varebiler skal synes 4 år efter første registrering og derefter hvert andet år, lastbiler, busser, taxier og tunge påhængskøretøjer hvert år, og køretøjer registreret til veterankørsel senest efter 35 år og derefter hvert ottende. En frist fra 1. jan. 2027 følger de regler, der gælder da, ognotessiger det. Udtrækket har kun det seneste syn, så et køretøj uden noget syn eroverduei 15 uger efter sin første frist og derefterunknown.overduegælder ud fra det seneste udtræk: et syn, der er sket siden, står ikke i det endnu. Det er et skøn: Færdselsstyrelsens indkaldelse fastsætter fristen, og en udsættelse står ikke i udtrækket. Felterne, der allerede er på/calculated, er uændrede.
23. okt. 2026
- Gennemsnit, karrosserityper og første registreringsdato i statistikken.
GET /v1/statistics/vehiclestageraverage, et eller flere afodometerReading,maximumPower,ownWeightogtotalWeight. Så har svaret og hver gruppeaverages, hver{ "value", "unit", "basedOn" }: gennemsnittet med én decimal, enheden, og hvor mange køretøjer det er over. En værdi uden for artens rimelige interval, som en egenvægt på 555.555.555.555.555.555 kg, er ikke med, i stedet for at blive skåret til. Intervallerne står i guiden.groupBytager ogsåbodyType,firstRegisteredYearogfirstRegisteredMonth(YYYY-MM, måneden forfirstRegisteredOn). Et ukendt eller gentaget mål giver400medAverageInvalid. Udenaverageer svaret som før. Se Køretøjsstatistik. - Periodiske afgifter på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharperiodicTaxes: de periodiske afgifter på en personbil, varebil eller motorcykel for en afgiftsperiode, der begynder i dag, med årets satser. Hver linje ilineser én afgift eller ét tillæg, somconsumptionTax,co2Tax,weightTax,equalisationTaxellerparticleSupplement, med sitamount, sinperiodMonths,perYearog etsource-link til den lov, der fastsætter den, ogtotalPerYearlægger dem sammen. Personbiler første gang registreret fra 1. jul. 1997 og varebiler op til 3.500 kg fra 18. mar. 2009 betaler grøn ejerafgift efter km/l, eller efter g CO2/km fra 1. jul. 2021, og ældre personbiler, motorcykler og ældre eller tungere varebiler betaler vægtafgift. Km/l er den, registret har på den primære drivmiddelrække, ogreasonfortæller, hvad der afgjorde det.notIncludednævner, hvad registret ikke kan vise, som privatbenyttelsestillægget for varebiler og fritagelser. Busser, lastbiler og påhængskøretøjer ernotCoveredindtil videre, og når registret mangler det, en regel kræver, som for en plugin-hybrid første gang registreret før 1. jul. 2021, erstatusunknownmed årsagen. Beregnet af Motorbay, ikke Motorstyrelsens opkrævning. Felterne, der allerede er på/calculated, er uændrede.
17. okt. 2026
- Køretøjets historik.
GET /v1/vehicles/{vehicleId}/history, oginclude=historypå opslagene af køretøjer (og dermedinclude=all), viser, hvad der har ændret sig for et køretøj fra det ene ugentlige udtræk til det næste:plates,statuses,registrationStatusesoginspectionsmed kilometerstand, hver med nyeste først. Hvert punkt harobservedOn, dagen for det udtræk, det først blev set i, ogchangedOn, den dag registret angiver for ændringen, når det angiver en.observedSinceer det tidligste udtræk, vi har for køretøjet. Historikken starter med udtrækket fra 18. okt. 2026, så indtil da er listerne tomme, ogobservedSinceernull. Et køretøj, der ikke findes, giver404medVehicleNotFound.units=imperialtilføjerconvertedtil hvert syn. Et kald er én forespørgsel, på alle abonnementer. Se Datakilde og aktualitet. - Miljøzoner på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharenvironmentalZones: om køretøjet må køre i de danske miljøzoner (København, Frederiksberg, Aarhus, Aalborg og Odense).statuserallowed,notAllowed,notAffectedellerunknown,reasonsiger, hvad der afgjorde det, fxeuroNorm,particleFilterellerfirstRegistration, ogsourceslinker til de regler, der er brugt. Miljøzonerne gælder kun diesel: en personbil eller minibus skal have Euro 5 eller et registreret partikelfilter, en varebil er også godkendt, når den er først registreret 1. sep. 2016 eller senere, og en lastbil eller bus over 3.500 kg skal have Euro VI, et filter eller første registrering 1. jan. 2015 eller senere. Et køretøj registreret til veterankørsel er undtaget. Mange dieselkøretøjer har ingen euronorm i registret: en personbil, minibus eller varebil, der er først registreret 1. jan. 2014 eller senere, regnes så som Euro 5, som EU's regler krævede af nye køretøjer på det tidspunkt, ogreasonereuroNormFromFirstRegistration. En registreret norm går altid forud. For et brugt importeret køretøj kan registrets første registrering være den danske dato, så et ældre køretøj kan se nyere ud, både når det regnes som Euro 5, og for datoerne for varebiler og tunge køretøjer. Når registret mangler det, en regel skal bruge, erstatusunknown, ogreasonsiger, hvad der mangler. Dispensationer står ikke i registret, så et køretøj med en dispensation står stadig somnotAllowed. Beregnet af Motorbay, ikke taget fra udtrækket. Felterne, der allerede er på/calculated, er uændrede. - Det kørekort, et køretøj kræver, på
/calculated.GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharlicenceCategory: den laveste danske kørekortkategori, der dækker køretøjet kørt alene, uden påhængsvogn.categoryerB,C1,C,D1,D,A1,A2,A,AM,smallMopedellertractorOrMotorTool,reasonsiger, hvad der afgjorde det,notesnævner betingelser, registret ikke kan tjekke, ogsourceslinker til kørekortbekendtgørelsen. En personbil, varebil eller lastbil op til 3.500 kg med højst 8 passagerer erB, op til 7.500 kgC1og deroverC. Flere end 8 passagerer erD1op til 16 ogDderover. Registret har ingen længde, såD1kommer med notend1OnlyUpTo8Metres. En motorcykel erA1,A2ellerAefter effekt, slagvolumen og effekt i forhold til vægt. Når registret mangler det, der afgør det, ercategorynull, ogreasonsiger, hvad der mangler, og det samme gælder for en påhængsvogn. Beregnet af Motorbay, ikke taget fra udtrækket. - Engelske opslagsnavne på amerikansk engelsk, og busser hedder busser. Med
Accept-Language: enændres ni navne:GasolineforBenzin(varPetrol),BusforStor personbil(varLarge passenger car),Travel trailerforCampingvogn(varCaravan),Goods transport (½ OMS.)for anvendelse 38 (varGoods transport (half VAT), et gæt på forkortelsen),Van bought before 18 Mar 2009for tilladelsestype 104 (vartraded),Dealer plates not allowedfor tilladelsestype 76 (varTrade plates),For-hire truckingfor tilladelsestype 9 (varHaulage for hire) oghitch ballfortow balli tilladelsestype 21 og 22. Kunnameændres. Id'er og det danskeoriginalNameer de samme, så match på id'et.
16. okt. 2026
- EU Safety Gate-tilbagekaldelser for et køretøj.
GET /v1/vehicles/{vehicleId}/recalls,/v1/vehicles/plate/{plate}/recallsog/v1/vehicles/vin/{vin}/recallsgiver de varsler om motorkøretøjer fra EU's Safety Gate (tilbagekaldelser og andre tiltag fra myndigheder i EU og EØS), som kan omfatte køretøjet. De findes ud fra køretøjets EU-typegodkendelsesnummer og produktionsdatoer, ikke ud fra stelnummeret, og hvert varselsmatchedOnsiger hvordan:typeApproval, når nummeret og dets udvidelse passer, ogtypeApprovalBase, når varslet eller registret ikke har en udvidelse at sammenligne. Tjek stelnummeret hos producenten eller en forhandler. Kun køretøjer med et EU-typegodkendelsesnummer i registret kan findes, omtrent halvdelen af den danske bilpark.canMatchsiger, om det gælder dette køretøj, og en tomalertsbetyder, at der ikke blev fundet et varsel, ikke at køretøjet ikke er kaldt tilbage. Varslerne er på engelsk som offentliggjort og opdateres hver uge. Vissource.attribution, hvor du viser dem: Europa-Kommissionen kræver det. Et kald tæller som én forespørgsel, ligesom/check./checker uændret.
14. okt. 2026
- To nye svar fra Free ved
429. En konto, der ikke har bekræftet et kort eller et telefonnummer, kan være begrænset til startopslag, én gang i hele kontoens levetid. Når de er brugt, har429med kodenQuotaExceededogsåverificationRequired: trueogverifyUrl, siden i konsollen, hvor du bekræfter kontoen, og ingenRetry-After. Free-abonnementet kan også have en kapacitet for hver dag, som alle konti på Free deler. Når den er brugt, får forespørgsler på Free et429med en ny kode,FreeCapacityExhausted, ogRetry-Afterløber til kl. 00.00 UTC. Ingen af delene gælder betalte abonnementer, og ingen af dem er slået til endnu. En klient, der kun ser på statuskoden429, skal ikke ændres. En, der vælger eftercode, bør behandleFreeCapacityExhaustedsom "vent til i morgen". Se Rate limits og kvoter. - Fejl på dansk. Send
Accept-Language: da, så er en fejlstitleogdetailpå dansk. Uden headeren, eller med et andet sprog end dansk, er de på engelsk, ord for ord som før, bortset fra at titlen påDatasetNotLoadedhar mistet sit punktum ligesom de andre titler.Content-Languagesiger, hvilket sprog der blev brugt.code, HTTP-status og nøglerne ierrorser de samme på begge sprog, så byg din logik på dem og ikke på teksten. Beskederne ierrorser stadig på engelsk. En browser sender selvAccept-Language, så en browserapp får nu dansk tekst til brugere, der foretrækker dansk. - En
405har en titel. En metode, en sti ikke tager, fxDELETE /v1/colors, gavtitleMethodNotAllowed, det samme somcode. Nu står derMethod not allowed, ellerMetoden er ikke tilladtpå dansk. - Opslagsnavne på engelsk. Send
Accept-Language: en, så ernamepå engelsk for arter, farver, anvendelser, drivmidler, euronormer, udstyr, blokeringer, tilladelsestyper og testprocedurer for forbrug, fxGrayforGråogPetrolforBenzin. Det gælder på deres egne endpoints og overalt, hvor et køretøj, et søgeresultat, en statistikgruppe eller et underendpoint viser dem. Uden headeren, eller når dansk foretrækkes, ernameMotorstyrelsens danske navn, som før.originalNameogidændrer sig aldrig, og mærker, modeller, varianter og typebetegnelser er egennavne og forbliver, som de er. En kode, Motorstyrelsen tilføjer, før vi har oversat den, beholder sit danske navn på begge sprog. Alle svar siger nuVary: Accept-Language. - Statistik i procent. Hver gruppe fra
GET /v1/statistics/vehiclesharshare, dens andel aftotali procent med to decimaler, fx12.11. Med to felter igroupByhar en gruppe ogsåshareOfParent, dens andel af køretøjerne med samme værdi i det første felt:groupBy=make,fuelTypegiver hvert mærkes fordeling på drivmidler. Begge kommer fra de samme præcise tal somcount, ogshareOfParentregnes ud fra alle grupper, også dem efterlimit. - Britiske enheder og hestekræfter efter ønske. De dele af et køretøj, der har en målt værdi (
/engine,/technical-details,/environmental-information,/inspectionog/fuel-types), og opslagene på køretøjer, for de deleincludetilføjer, tagerunits,powerogmpg.units=imperialtilføjerconvertedtil hver af de dele, med hvert målt felt som{ "value", "unit" }: vægte ilb, sporvidder og akselafstand iin, slagvolumen iin3, tophastighed imph, kilometerstanden ithousandMi, brændstoføkonomi impgUs(ellermpgUkmedmpg=uk), CO₂ igPerMi, elforbrug iwhPerMiog emissioner imgPerMi.power=hpgiver effekten i mekaniske hestekræfter (745,7 W, så 100 kW er 134,1hp), med begge systemer. Det er ikke de metriske hestekræfter (hk, 735,5 W), somhorsepowerpå/calculatedgiver, og som er 136 for samme motor. Omregnede værdier er afrundet til 1 decimal (emissioner til 2) og beregnet af Motorbay, ikke taget fra udtrækket. De rå felter ændrer sig aldrig: de står i Motorstyrelsens enheder. Uden parametrene, eller medunits=metric, er svaret det samme som før, byte for byte, udenconverted. En værdi, vi ikke tager imod, ellermpgudenunits=imperial, giver400med kodenValidationFailedogUnitsInvalidierrors. Se Enheder. - Konsollens fejlbeskeder på dansk. På en dansk side er beskederne fra oprettelse, login og din konto nu også på dansk. Det gælder en adgangskode, der er for kort, en forkert adgangskode eller 2FA-kode, ændrede vilkår og en e-mailadresse, der ikke kan bruges. Konsollen sender sidens sprog i
Accept-Language, og svaret siger iContent-Language, hvilket sprog det brugte. UdenAccept-Language: daer beskederne på engelsk, ord for ord som før. Koderne er de samme på begge sprog.
11. okt. 2026
GET /v1/usagehar taggetAccount. I API-referencen og OpenAPI-dokumentet stod det underData.WebApi. Selve endpointet er uændret.- Søg på drivmiddel og første registreringsdato.
GET /v1/vehiclestagerfuelTypeId, et drivmiddel fraGET /v1/fuel-types, og finder køretøjer med det som primært drivmiddel: det,GET /v1/vehicles/{id}/fuel-typesviser først, medisPrimarysat til true. Den tager ogsåfromFirstRegisteredOnogtoFirstRegisteredOnsomYYYY-MM-DD, begge dage med, sammenlignet med køretøjetsfirstRegisteredOn. Køretøjer uden værdien er ikke med. En dato, der ikke erYYYY-MM-DD, giver400med kodenValidationFailedogFirstRegisteredOnInvalidierrors.GET /v1/statistics/vehiclestager ogsåfuelTypeId. - Et flag for umulige modelår.
GET /v1/vehicles/{vehicleId}/calculatedoginclude=calculatedharmodelYearPlausible:false, når registretsmodelYearligger efter udtrækkets år plus ét eller før 1885,trueellers, ognulluden modelår.modelYearleveres stadig, som Motorstyrelsen har registreret det, og beskrivelsen i API-referencen siger det nu. - Statistik pr. drivmiddel.
GET /v1/statistics/vehiclestagerfuelTypeigroupBy, alene eller med ét andet felt:groupBy=make,fuelTypetæller hvert mærke pr. drivmiddel. En gruppesfuelTypeer det primære drivmiddel, det samme somfuelTypeIdfiltrerer på, med navn. Køretøjer uden primært drivmiddel er en gruppe medfuelType: null. - Skemaet for en statistikgruppe passer til svarene. En gruppe har kun de felter, den er grupperet efter, og
count, som den altid har haft. OpenAPI-dokumentet angav alle grupperingsfelter som påkrævede, så en klient lavet ud fra det kunne afvise et rigtigt svar. Nu er kuncountpåkrævet. Svarene er uændrede. - En parameter, der ikke er et tal, siger hvilken.
makeId=abc,page=abceller/v1/colors/abcgav400medValidationFailedog udenerrors, så svaret sagde ikke, hvad der skulle rettes. Det giver stadig400medValidationFailed, ogerrorshar nuParameterInvalidmed en besked, der nævner parameteren.
10. okt. 2026
- En tydeligere
402. Alle konti har nu en plan, så402med kodenPaymentRequiredbetyder ikke længere, at du ingen plan har. Det betyder, at det betalte abonnement er i en tilstand, vi ikke kan bekræfte, for eksempel forfaldent eller opsagt. Kun beskrivelsen i API-referencen er ændret. - Slå mange nummerplader op i ét kald.
POST /v1/vehicles/platestager{"plates": ["AB12345", "cd 67-890"]}med 1 til 500 nummerplader og svarer med{"results": [...]}med ét element pr. nummerplade i den rækkefølge, du sendte dem. Hver nummerplade læses på samme måde som iGET /v1/vehicles/plate/{plate}, og en nummerplade på flere køretøjer giver det samme køretøj som det endpoint. Et element harplate(som du sendte den),normalizedPlate,foundog entenvehicle(samme objekt som ved det enkelte opslag) ellererror.error.codeerVehicleNotFoundfor en gyldig nummerplade, som intet køretøj har i det udtræk, vi har indlæst, ellerInvalidPlatemed enmessagefor en nummerplade, der ikke er gyldig. En ugyldig nummerplade får ikke kaldet til at fejle. En body, der ikke er en liste med 1 til 500 tekststrenge, giver400med kodenValidationFailed, og en body over 64 KB giver413med kodenPayloadTooLarge. - Hvad en batch koster. Kaldet tæller som én forespørgsel pr. forskellig gyldig nummerplade på din månedlige kvote, og kvoten tjekkes for dem alle, før der slås noget op. En nummerplade, der er sendt to gange eller skrevet på to måder (
ab12345ogAB-12345), tæller én gang, og en ugyldig nummerplade tæller ikke. Et kald uden en eneste gyldig nummerplade tæller som én forespørgsel. Hvis din konto ikke kan dække dem alle, bliver hele kaldet et429med kodenQuotaExceeded, uden resultater og uden at noget er talt. For grænsen på 60 forespørgsler i minuttet pr. nøgle er hele kaldet én forespørgsel. - Værdier, Motorbay beregner.
GET /v1/vehicles/{vehicleId}/calculatedreturnererhorsepower(hk),agei år og måneder medageUntil,annualKilometers,powerToWeight,isElectric,isPluginHybrid,manufacturerRegionogmanufacturerCountry(ud fra stelnummeret efter ISO 3780) samtcalculatedOn. Motorbay beregner dem, de står ikke i udtrækket, og de rå værdier er uændrede. Hvert felt i API-referencen beskriver, hvordan det beregnes. Et køretøj, der ikke findes, giver404med kodenVehicleNotFound. - Et køretøj og dets dele i ét kald.
GET /v1/vehicles/{id},GET /v1/vehicles/plate/{plate}ogGET /v1/vehicles/vin/{vin}tagerinclude, kommasepareret (include=engine,inspection) eller gentaget (include=engine&include=inspection). Værdierne ertechnicalDetails,engine,environmentalInformation,inspection,fuelTypes,equipment,secondaryUsages,blockingReasons,permits,leasingPeriods,check,calculatedellerall. Hver tilføjer en egenskab med samme navn, der indeholder det, dens eget endpoint returnerer: objektet (null, hvor det endpoint svarer204) eller alle elementer i listen uden sideinddeling. Udenincludeer svaret uændret. En ukendt værdi giver400med kodenValidationFailedogIncludeInvalidierrors, der nævner værdien. Kaldet tæller som én forespørgsel. - Ét opslag til nummerplade eller stelnummer.
GET /v1/vehicles/lookup/{plateOrVin}læser en værdi på præcis 17 bogstaver og cifre uden I, O og Q som et stelnummer (VIN) og alt andet som et registreringsnummer. Det svarer præcis det samme som/v1/vehicles/vin/{vin}eller/v1/vehicles/plate/{plate}, også404med kodenVehicleNotFound, og tager ogsåinclude. - Kun besvarede forespørgsler tæller med i dit abonnement. Et svar, der ikke er
2xx, som en404,400,413eller5xx, tæller ikke længere med i din måned. Abonnementet tjekkes stadig, før forespørgslen kører, og forespørgslen gives tilbage bagefter. Grænsen på 60 forespørgsler i minuttet pr. nøgle tæller stadig alle forespørgsler. - En batch koster de nummerplader, den fandt.
POST /v1/vehicles/platestjekkes for hver forskellig gyldig nummerplade, før der slås noget op, som før, og de nummerplader, som intet køretøj har, gives tilbage bagefter. - Din måned i ét kald.
GET /v1/usagesvarer medperiodStartogperiodResetsOn(YYYY-MM-DD, UTC),requestsfor hele kontoen denne måned,includedRequests,hardLimitogremaining(beggenullpå et abonnement uden loft),planName,planTypeogkeyRequestsfor den nøgle, du sendte. Det er gratis: det tæller ikke med i dit abonnement, og det tæller med i grænsen pr. minut som alle forespørgsler. - E-mails om kvoten. Vi sender dig en e-mail én gang, når måneden passerer 80 % af dit abonnements inkluderede forespørgsler, og én gang ved 100 %.
- Søg efter registreringsstatus.
GET /v1/vehiclestagerregistrationStatus:registered,deregistered,unknownellerpending, stavet som et køretøjsregistrationStatus. Det kan kombineres med de andre filtre, ogtotalCounter stadig præcis. Enhver anden værdi giver400med kodenRegistrationStatusInvalid. - Køretøjsstatistik.
GET /v1/statistics/vehiclestager de samme filtre som køretøjssøgningen og svarer med{"total": n, "groupCount": n, "groups": [...]}. MedgroupBy, et eller to afmake,kind,usage,color,modelYearogregistrationStatus, har hver gruppe de grupperede felter og sincount, største først, højstlimitaf dem (standard 50, højst 1000). Mærker, arter, anvendelser og farver kommer med navn. Tallene beskriver det ugentlige udtræk, vi har indlæst, somMotorbay-Data-As-Offortæller, og ét kald er én forespørgsel. En forkertgroupBygiver400medGroupByInvalid, tre eller flere felterGroupByTooMany, og enlimituden for det tilladteLimitOutOfRange. Se Køretøjsstatistik.
9. okt. 2026
- Tjek af brugt bil.
GET /v1/vehicles/{vehicleId}/check,GET /v1/vehicles/plate/{plate}/checkogGET /v1/vehicles/vin/{vin}/checksamler risikosignalerne for et brugt køretøj i ét svar:statusogregistrationStatusmed datoer,blocks,hasTrafficDamage,hasRestampedVinogvinRestampedAt,activeLeasingPeriod,latestInspection(resultat, dag og kilometerstand),registrationNumberExpiresOnogflags. Hvert flag har encode(fxtotalLosselleractiveLeasing), enseverity(high,mediumellerinfo) og en kort engelsklabel, de alvorligste først. En leasingperiode er aktiv, når den dækkercheckedOn, den danske kalenderdag for forespørgslen, begge dage medregnet. Tjekket bygger på det seneste ugentlige udtræk, vi har indlæst, så et køretøj uden flag er ingen garanti. Et ukendt køretøj giver404med kodenVehicleNotFound. - Blokeringer pr. køretøj.
GET /v1/vehicles/{vehicleId}/blocking-reasonsviser de blokeringer, der er registreret på et køretøj i det seneste udtræk, vi har indlæst, i id-rækkefølge. Hvert element harid,nameogoriginalName, fx"3","Totalskadet køretøj". Det er en sideinddelt liste som/equipment: et køretøj uden blokeringer giver200med"data": [], og et ukendt køretøj giver404med kodenVehicleNotFound. En blokering, vi endnu ikke kan beskrive præcist, vises som den generelle blokering"0","Køretøjet er blokeret", og den generelle blokering står kun én gang. - Blokeringsårsager som referencedata.
GET /v1/blocking-reasonsogGET /v1/blocking-reasons/{id}viser blokeringsårsager på samme måde som farver og arter. En ukendt blokeringsårsag giver404med kodenBlockingReasonNotFound. - Tilladelser pr. køretøj.
GET /v1/vehicles/{vehicleId}/permitsviser de tilladelser, der er registreret på et køretøj, nyeste først, fx"Stelnummer Genihugget"(et genindslået stelnummer) eller en tilkobling af påhængskøretøj. Hvert element harvalidFromAt(et tidspunkt i UTC),typesom{ "id", "name", "originalName" },fixedConnectionogvariableCombination. Kommentarer til tilladelser er ikke med, fordi de kan indeholde persondata.GET /v1/permit-typesogGET /v1/permit-types/{id}viser tilladelsestyper. En ukendt tilladelsestype giver404med kodenPermitTypeNotFound. - Leasingperioder pr. køretøj.
GET /v1/vehicles/{vehicleId}/leasing-periodsviser et køretøjs leasingperioder, nyeste start først, medvalidFromOnogvalidUntilOnsomÅÅÅÅ-MM-DD.validUntilOnernullfor en periode uden slutdato.
8. okt. 2026
- Drivmidler og forbrug pr. køretøj.
GET /v1/vehicles/{vehicleId}/fuel-typesviser de drivmidler, et køretøj kører på, det primære først. Hvert element harfuelTypesom{ "id", "name", "originalName" },isPrimary,kilometersPerLiter,co2Emission(g/km),electricConsumption(Wh/km),hasFuelCellogefficiencyTestProcedure(fx WLTP ellernull). Det er en sideinddelt liste som/equipment: et køretøj uden registrerede drivmidler giver200med"data": [], og et ukendt køretøj giver404med kodenVehicleNotFound. - Drivmidler som referencedata.
GET /v1/fuel-typesogGET /v1/fuel-types/{id}viser drivmidler på samme måde som farver og arter. Et ukendt drivmiddel giver404med kodenFuelTypeNotFound.
7. okt. 2026
- Modelår har sit eget indeks. En søgning med
fromModelYearellertoModelYear, der ramte få køretøjer, fxtoModelYear=1990, kunne køre i 30 sekunder og fejle med 500. Med indekset svarer flere af den slags søgninger på under 2 sekunder. Andre, fxtoModelYear=2000, gik stadig i timeout indtil den næste ændring. - Søgninger, der rammer få køretøjer, svarer på sekunder. En søgning, der ramte op til 100.000 køretøjer, kunne stadig køre i 30 sekunder og fejle med 500, når de køretøjer kom sidst i sorteringen, fx
toModelYear=2000. Sådan en søgning får nu 2 sekunder til at svare på den sædvanlige måde, og derefter læses siden ved kun at sortere de køretøjer, der passer. De søgninger af den slags, vi har målt, svarer på cirka 2 til 5 sekunder og op til 15 sekunder første gang, en søgning køres, mens dens data læses fra disken. Siden ogtotalCounter de samme begge veje. En søgning, der rammer mere end 100.000 køretøjer, læses som før, og nogle af dem kan stadig tage op til 30 sekunder eller fejle, fx et bredt interval af modelår (fromModelYear=2015&toModelYear=2020). - Gentagne forespørgsler svarer fra hukommelsen. API'et gemmer nu hvert svar i op til et døgn og aldrig ud over næste ugentlige import, så når du spørger efter det samme køretøj, den samme søgeside eller liste igen, går det ikke til databasen. Svaret er det samme, det tæller stadig som en forespørgsel i din grænse og plan, og
Motorbay-Data-As-Ofsiger stadig, hvilket udtræk det kommer fra. Efter en import svarer API'et fra det nye udtræk inden for 5 minutter, som før.
6. okt. 2026
- Brede søgninger i køretøjer er meget hurtigere. En søgning, der ramte millioner af køretøjer, fx uden filter eller med
kindIdfor personbiler, tog 15 til 20 sekunder, forditotalCountblev talt køretøj for køretøj. Nu kommer det fra optællinger, som importen gemmer for hver kombination af søgefiltrene, og sådan en søgning svarer typisk på under et sekund.totalCounter stadig nøjagtig, og intet i svaret er ændret.
5. okt. 2026
- Køretøjer kommer med navne. Et køretøj indeholder nu det, det henviser til, med navn:
kind,make,model,variant,designationType,color,emissionStandardogprimaryUsage, hver som{ "id", "name", "originalName" }, de samme felter som referenceendpointene returnerer. Du behøver ikke længere et kald til/v1/colors/{id}eller/v1/makes/{id}for at vise "Grå" eller "VOLKSWAGEN". Det gælder/v1/vehicles/{id},/v1/vehicles/vin/{vin},/v1/vehicles/plate/{plate}og søgning i køretøjer. Felterne, der ender påId, er uændrede. En reference, køretøjet ikke har, ernull.variantogdesignationTypekan også værenull, selvomvariantIdellerdesignationTypeIdhar en værdi: Motorstyrelsen har dem pr. model, og et køretøj uden model har ingen, vi kan sætte navn på. - Udstyr og sekundære anvendelser kommer med navne.
GET /v1/vehicles/{vehicleId}/equipmentogGET /v1/vehicles/{vehicleId}/secondary-usagesharnameogoriginalNamefor hvert element ved siden af detsid.
28. sep. 2026
- Tidspunkter er i UTC. Alle tidspunkter, altså felter, der ender på
At, ogimportedAtpå/v1/dataset, sendes i UTC med etZ, for eksempel2026-09-18T08:43:12.345Z. Før havde nogle+02:00. Tidspunktet er det samme. - Navne i referencedata er Motorstyrelsens tekst. Feltet
namei referencedata er Motorstyrelsens danske tekst, det samme somoriginalName.
26. sep. 2026
- 503, når din nøgle ikke kan kontrolleres. Når din API-nøgle ikke kan kontrolleres et øjeblik, svarer API'et
503med kodenServiceUnavailableog enRetry-After-header i stedet for401. Din nøgle er i orden: prøv igen efter det angivne antal sekunder. HEAD /health/data.GET /health/datasvarer også påHEAD, til overvågningstjenester, der kun senderHEAD.
25. sep. 2026
- Opslag på nummerplade normaliserer input.
GET /v1/vehicles/plate/{plate}trimmer, skriver med store bogstaver og fjerner mellemrum og bindestreger, såab 12 345finderAB12345. Input med andre tegn end A til Z, 0 til 9, Æ, Ø og Å, eller længere end 10, giver400med den nye regelkodeRegistrationNumberInvalid. - Opslag på nummerplade vælger det rigtige køretøj. Når flere køretøjer har haft et registreringsnummer, returnerer opslaget det, der er registreret med det nu, ellers det seneste. Svaret ændrer sig ikke længere mellem forespørgsler.
- Søg på registreringsnummer.
GET /v1/vehicles?registrationNumber=viser alle køretøjer, der har haft et registreringsnummer, i den rækkefølge, opslaget vælger fra.
24. sep. 2026
Den første version af API'et, /v1.
- Køretøjer efter id, stelnummer og registreringsnummer, med tekniske oplysninger, motor, miljøoplysninger, syn, udstyr og sekundære anvendelser.
- Køretøjssøgning med filtre på mærke, art, anvendelse, farve og modelår, sortering med
sortByog højst 10.000 resultater pr. søgning. - Referencedata: mærker, modeller, varianter, typebetegnelser, farver, arter, anvendelser, euronormer og udstyr.
GET /v1/datasetog headerenMotorbay-Data-As-Of, så du kan se, hvor gamle data er.- Godkendelse med headeren
X-Api-Key. - Fejl som problem details med en stabil
codeog enX-Request-Id-header på alle svar. - 60 forespørgsler i minuttet pr. nøgle.
Fandt du ikke svaret? Skriv til support@motorbay.app.