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.

28. sep. 2026

Tidspunkter er i UTC. Alle tidspunkter, altså felter, der ender på At, og importedAt på /v1/dataset, sendes i UTC med et Z, for eksempel 2026-09-18T08:43:12.345Z. Før havde nogle +02:00. Tidspunktet er det samme.
Navne i referencedata er Motorstyrelsens tekst. Feltet name i referencedata er Motorstyrelsens danske tekst, det samme som originalName.

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 503 med koden ServiceUnavailable og en Retry-After-header i stedet for 401. Din nøgle er i orden: prøv igen efter det angivne antal sekunder.
HEAD /health/data. GET /health/data svarer også på HEAD, til overvågningstjenester, der kun sender HEAD.

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 345 finder AB12345. Input med andre tegn end A til Z, 0 til 9, Æ, Ø og Å, eller længere end 10, giver 400 med den nye regelkode RegistrationNumberInvalid.
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 sortBy og højst 10.000 resultater pr. søgning.
Referencedata: mærker, modeller, varianter, typebetegnelser, farver, arter, anvendelser, euronormer og udstyr.
GET /v1/dataset og headeren Motorbay-Data-As-Of, så du kan se, hvor gamle data er.
Godkendelse med headeren X-Api-Key.
Fejl som problem details med en stabil code og en X-Request-Id-header på alle svar.
60 forespørgsler i minuttet pr. nøgle.

Sådan versionerer vi API'et

28. sep. 2026

Tidspunkter er i UTC. Alle tidspunkter, altså felter, der ender på At, og importedAt på /v1/dataset, sendes i UTC med et Z, for eksempel 2026-09-18T08:43:12.345Z. Før havde nogle +02:00. Tidspunktet er det samme.

Navne i referencedata er Motorstyrelsens tekst. Feltet name i referencedata er Motorstyrelsens danske tekst, det samme som originalName.

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 503 med koden ServiceUnavailable og en Retry-After-header i stedet for 401. Din nøgle er i orden: prøv igen efter det angivne antal sekunder.

HEAD /health/data. GET /health/data svarer også på HEAD, til overvågningstjenester, der kun sender HEAD.

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 345 finder AB12345. Input med andre tegn end A til Z, 0 til 9, Æ, Ø og Å, eller længere end 10, giver 400 med den nye regelkode RegistrationNumberInvalid.

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 sortBy og højst 10.000 resultater pr. søgning.

Referencedata: mærker, modeller, varianter, typebetegnelser, farver, arter, anvendelser, euronormer og udstyr.

GET /v1/dataset og headeren Motorbay-Data-As-Of, så du kan se, hvor gamle data er.

Godkendelse med headeren X-Api-Key.

Fejl som problem details med en stabil code og en X-Request-Id-header på alle svar.

60 forespørgsler i minuttet pr. nøgle.