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)"
}

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:39Z

Nå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-DD uden tidszone, i felter hvis navne ender på On, fx firstRegisteredOn.
• Tidspunkter er ISO 8601 med UTC-forskydning, i felter hvis navne ender på At, fx statusUpdatedAt. Forskydningen er ikke altid Z: /v1/dataset sender +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 som isMaximumPowerUnavailable, der er true, 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 registered og deregistered. 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 name og originalName, Motorstyrelsens danske tekst. I dag er name den samme danske tekst, fx Personbil. Engelske navne i name kan komme senere.
• 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.

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 345 og AB-12345 finder AB12345.
• Kun A til Z, 0 til 9, Æ, Ø og Å accepteres, højst 10 af dem. Alt andet giver 400 med RegistrationNumberInvalid under errors.
• 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 registrationStatus fortæller, at det ikke længere er registreret. Svaret er det samme ved hver forespørgsel.
• GET /v1/vehicles?registrationNumber=AB12345 viser alle køretøjer, der har haft det, i samme rækkefølge, så det første element er det, opslaget returnerer.