API for tekniske kjøretøyopplysninger med eierinformasjon og API for kjøretøyhendelser
Statens vegvesen tilbyr API-er for ulike områder. Slik kan virksomheter integrere sine fagsystemer med for eksempel Kjøretøyregistret.
Virksomheten er ansvarlig
Ved bruk av Statens vegvesens API-er mottar virksomheten personopplysninger og blir behandlingsansvarlig. Virksomheten din er ansvarlig for at opplysningene brukes i tråd med regelverket. Dataene fra API-et egner seg ikke til alle formål, som for eksempel å etablere historiske registre.
Innhold på siden
- Behandling av personopplysninger
- API for tekniske kjøretøyopplysninger med eierinformasjon
- Prisoversikt API kjøretøyopplysninger med eierinformasjon
- API for kjøretøyhendelser
- Prisoversikt API kjøretøyhendelser
- Tilgang til tjenestene via Altinn
- Data du får via API-ene
- Slik bruker du API-et og bestiller tilgang
Behandling av personopplysninger
Før du tar i bruk API-et er det vikitg å sette seg inn i hva virksomheten din er ansvarlig for når dere håndterer personopplysninger.
Personopplysninger og ansvar
Når du mottar data fra Statens vegvesen, mottar du personopplysninger som krever behandling i tråd med din virksomhets behandlingsgrunnlag (datatilsynet.no). Virksomheten din er behandlingsansvarlig når dataene mottas og har ansvaret for å etterleve pliktene etter personopplysningsloven.
Virksomheten din har ansvar for å sikre at dataene ikke deles ulovlig, og at det ikke brukes flere opplysninger enn nødvendig. Sett deg nøye inn i regelverket før du mottar data fra oss. Vi anbefaler å starte med å se på Datatilsynets nettsider.
Viderebruk av data
Informasjon om navn/adresser fra Kjøretøyregistret kan ikke benyttes til å lage et historisk register, som kan si noe om hvor kjøretøyet befant seg i et gitt årstall eller dato. Dette vil gi et uriktig bilde og være i strid med lov om behandling av personopplysninger (GDPR) (lovdata.no). Dette fordi navn og adresser på personer i Kjøretøyregistret oppdateres løpende mot endringer i Folkeregistret.
Historiske data får du ved oppslag med dato (DTG). Slike kall kan gjøres for å få opplysninger om hvem som eide/leaset kjøretøyet på et gitt tidspunkt. Det publiseres ikke hendelser ved endring i historiske data, eller ved endring på adressebeskyttelsesstatus. Opplysninger du har fått med datospørring er derfor kun gyldig i 24 timer.
Oppdatering av personopplysninger
Vi oppdaterer løpende vår informasjon opp mot Folkeregistret. Når du har mottatt data fra oss, er du selv ansvarlig for å sørge for at denne informasjonen er korrekt og oppdatert. Husk derfor å oppdatere din lagrede informasjon mot Kjøretøyregistret. Dette bør gjøres hvert døgn, for blant annet å ivareta sikkerheten til enkeltpersoner som skjermes i Folkeregistret. Folkeregistret er ansvarlig for at deres register er oppdatert.
API for tekniske kjøretøyopplysninger med eierinformasjon
API står for Application Programming Interface, som tillater programvaresystemer å kommunisere med hverandre. Hvis du vil bruke våre API-er, må du selv sørge for at ditt IT-system kan snakke med vårt system. For å få det til, trenger du kunnskap om programmeringsspråk, nettverkskommunikasjon og ofte også sikkerhetspraksis.
Staten vegvesen tilbyr API for tekniske kjøretøyopplysninger med eierinformasjon. Du kan gjøre spørring på ett konkret kjøretøy eller eier av kjøretøy og få returnert kjøretøyopplysninger og eierinformasjon på et gitt tidspunkt.
API-et er utviklet av Statens vegvesen for virksomheter som inngår avtale om bruk av tjenesten og som ønsker å integrere sine fagsystemer med Kjøretøyregisteret. Tjenesten kan benyttes av virksomheter direkte eller der virksomheter delegerer oppgaven til en underleverandør.
Tjenesten er delt inn i 3 produkter. Hvert produkt har en kvote for oppslag per døgn, basert på behovet for antall returnerte kjøretøy til sammen per døgn. Kvotene er på maks 5 000, 25 000 og 50 000 returnerte kjøretøy til sammen per døgn.
API for kjøretøyhendelser
Staten vegvesen tilbyr i tillegg et API for kjøretøyhendelser som viser når et kjøretøy har en hendelse, for eksempel nyregistrering, eierskifte, eller teknisk godkjenning av kjøretøy. Denne informasjonen kan brukes i kombinasjon med «API for tekniske kjøretøyopplysninger med eierinformasjon». Dette gjør det mulig å holde ditt eget register oppdatert.
| Produkt | Beskrivelse | Pris per måned uten mva. i NOK |
|---|---|---|
| API Kjøretøyhendelser | Informasjon om hendelser i Kjøretøyregisteret | 5 000 |
Tilgang til tjenestene
For å få tilgang til API-ene må du som representant for virksomheten først godkjenne våre vilkår. Ved å godkjenne vilkårene samtykker du til virksomhetens plikter og rettigheter for bruk av tjenesten. I vilkårene får dere også informasjon om formålet med tjenesten, tilgangsstyring og hva som skjer ved brudd på vilkår. Du godkjenner vilkårene etter at du logger inn.
For å kunne bestille API-nøkkel for virksomheten må du i Altinn ha enkelttjenesten «Kjøretøyoppslag» eller en tilgangspakke som inkluderer denne.
For å godkjenne vilkårene på vegne av en virksomhet må du ha en norsk elektronisk ID (BankID/Buypass/Commfides) og de riktige rettighetene i Altinn for virksomheten.
For å kunne se og signere avtaler på vegne av en virksomhet må du i Altinn ha de to enkelttjenestene «Se avtaleinformasjon på vegne av virksomheten» og «Signere avtaler på vegne av virksomheten», eller en tilgangspakke som inkluderer dem.
Data du får via API-ene
Tjenestene gir tilgang til helt ferske data og et rikt og godt strukturert datasett.
API for tekniske kjøretøyopplysninger med eierinformasjon
Med API for tekniske kjøretøyopplysninger med eierinformasjon får du tilgang til det tekniske datasettet for et kjøretøy, som blant annet inkluderer
- registreringsdata
- miljødata
- mål og vekt
- motor/kraftoverføring
- dekk og felg
- eieropplysninger
I tillegg inneholder tjenesten dato for forrige EU-kontroll og frist for neste. Tjenesten inneholder også datoer for når kjøretøyet ble registrert i Norge første gang, og når det ble registrert på nåværende eier for første gang. Du får ikke kjøretøyets kilometerstand i tjenesten.
Eieropplysninger
Ved oppslag på kjøretøyets registreringsnummer eller understellsnummer via API-et, vil responsen returnere navn og adresse for eier(e). Ved oppslag på organisasjonsnummer eller fødselsnummer i kombinasjon med etternavn gir responsen eierinformasjon i form av navn og poststed.
API for kjøretøyhendelser
Med API for kjøretøyhendelser får du tilgang til informasjon om hendelser i Kjøretøyregisteret, som blant annet inkluderer
- registrering
- eierskifte
- adresseendringer
- tekniske godkjenninger
Slik bruker du API-et
Når virksomheten din har inngått avtale med Statens vegvesen, må dere utvikle funksjonalitet som gjør det mulig å slå opp og motta respons via API-et. Statens vegvesen benytter Maskinporten for autentisering og tilgangskontroll for tjenesten. For å bruke API-et må dere ta i bruk Maskinporten.
Få tilgang til testmiljøet
Tilgang til testmiljøet er gratis og krever ikke at du har inngått avtale med Statens vegvesen om tilgang til tjenesten. For å få tilgang til testmiljøet må du sende e-post med ditt organisasjonsnummer og be om tilgangen.
Avslutt abonnementet
Viss du ønsker å avslutte abonnementet på tjenesten kan du sende en e-post.