Digitaliseringsdirektoratet moderniserer Altinn for å sikre brukervennlige, sikre og kostnadseffektive fellesløsninger. Altinn 2 vil erstattes av nye moderniserte fellesløsninger som omtales som Altinn 3. Digitaliseringsdirektoratet vil skru av Altinn 2 19. juni 2026, men mye Altinn 2 funksjonalitet vil slutte å fungere allerede 31. mai 2026.

Som følge av at Digitaliseringsdirektoratet moderniserer sine Altinn fellesløsninger må alle offentlige tjenesteleverandører, som for eksempel Nav og Skatteetaten (Skatteetaten reetablerer tjenester på egen plattform og tar i bruk fellesløsninger fra Altinn), skrive om sine tjenester mot arbeidsgivere. Nav har kommet langt i arbeidet med å ta fram nye grensesnitt både for manuell innsending og innsending fra sluttbrukersystem som for eksempel Lønns- og personalsystem (LPS). Se også Nav moderniserer tjenester for arbeidsgivere.

Mange virksomheter har i dag spesialtilpassede integrasjoner mot Altinn 2. For å kunne videreføre eller tilpasse integrasjonene, må dere ta direkte kontakt med de teamene i Nav som forvalter API-ene dere ønsker å benytte. De kan gi dere nødvendig informasjon om endringer, alternativer og migreringsløp. Dere finner kontaktinformasjon for spesifikke API i Nav API-oversikt.

Nav vil fortløpende dele oppdatert informasjon for å gjøre overgangen så enkel som mulig for alle eksterne aktører.

Denne siden gir en oversikt over hvordan Nav deler API med eksterne. Nav tilbyr API til mange forskjellige aktører, for eksempel:

• arbeidsgivere
• offentlige virksomheter
• kommuner
• spesielle bransjer som for eksempel forsikringsselskap og tjenestepensjonsleverandører.

For å forstå hvordan et bestemt API fungerer, klikk deg inn på lenke til API-et i Nav API-oversikt. Her finner du detaljert beskrivelse av API-et, kontaktinformasjon for det respektive API-et og annen informasjon om API-et. Oversikten er foreløpig ikke komplett, men vil bli utvidet og oppdatert fortløpende. Dersom du ikke finner det du leter etter, ta kontakt ekstern.datautveksling@nav.no.

Merk at mange av API-ene kun skal benyttes av for eksempel en bestemt bransje, og noen API-er krever egne samarbeidsavtaler med Nav for å få tilgang. Sjekk derfor på det enkelte API-et hvilke krav som gjelder.

For mange av Navs API må konsumenten akseptere bruksvilkår. I bruksvilkårene vil du se hvilke krav som stilles til konsumenten. Det kan for eksempel være krav om å etterleve et bestemt lovverk, krav om hvor raskt man må tilpasse seg nye versjoner av et API og krav om å holde Nav oppdatert på kontaktinformasjon. For noen API vil man i tillegg til å akseptere bruksvilkår også måtte søke om tilgang.

Alle Navs API som ikke er åpne, er sikret med Maskinporten (forvaltet av Digitaliseringsdirektoratet). For å kunne benytte disse må derfor virksomheten deres ha tilgang til Maskinporten, se hvordan få tilgang til Nav-API.

Flere av API-ene Nav tilbyr, understøtter at en virksomhet kan representere en annen virksomhet. Når en virksomhet skal benytte et API på vegne av en annen, må den andre virksomheten ha delegert rettighetene til å kalle API-et i Altinn Autorisasjon (forvaltet av Digitaliseringsdirektoratet), se hvordan representere andre virksomheter.

Digitaliseringsdirektoratet tilbyr Maskinporten som offentlig fellesløsning for å identifisere og autentisere virksomheter ved kall av API som offentlige virksomheter tilbyr. Alle Nav-API er satt opp med bruk av Maskinporten. For å få tilgang kreves det et kundeforhold hos Digitaliseringsdirektoratet. Se også informasjon til leverandører og kom i gang.

Dette gjør dere som virksomhet for å få tilgang til Maskinporten:

1. Leverandører som skal benytte Nav-API må være registrert hos Digitaliseringsdirektoratet for å kunne benytte Digitaliseringsdirektoratets fellesløsninger, se Registreringsskjema — Sluttbrukersystemleverandør i Altinn
2. For å få tilgang til Maskinporten må man fylle ut informasjonsskjema til Digitaliseringsdirektoratet
3. Opprett tilgang til Samarbeidsportalen
4. Les og signer bruksvilkår:
   1. Offentlige kunder signerer Bruksvilkår for offentlege kunder
   2. Private virksomheter signerer Bruksvilkår for private virksomheter
   3. Virksomheter som er leverandører og tilbyr løsninger på vegne av mange andre virksomheter skal i tillegg signere Bruksvilkår for leverandører. Se også hvordan representere andre virksomheter.
5. Til slutt må man sette opp en Maskinporten klient, se hvordan sette opp Maskinporten. Se også hvordan ta i bruk Maskinporten.

For utfyllende informasjon bes leverandører ta en titt på hvordan ta i bruk Digitaliseringsdirektoratets fellesløsninger.

Det er ganske vanlig at en virksomhet, som oftest leverandør, benytter et API på vegne av flere andre virksomheter (kunder) som leverandøren bygger en tjeneste for. Dette er mest utbredt på API-ene som er rettet mot arbeidsgivere, men gjelder også for en del andre API. Når en virksomhet (leverandør) skal benytte et API på vegne av en annen virksomhet (kunde), må kunden ha delegert de nødvendige rettighetene til leverandøren i Altinn Autorisasjon (forvaltet av Digitaliseringsdirektoratet).

Digitaliseringsdirektoratet tilbyr to alternative måter å representere en annen virksomhet på:

1. Delegerbare API
2. Bruk av Systembruker

Hvilket alternativ som gjelder for et visst API, finner du i dokumentasjonen til det enkelte API, se Nav API-oversikt.

Slik fungerer det med delegerbare API

Tjenesteeieren (i dette tilfellet Nav) tilbyr et API med et scope i Maskinporten. En leverandør må gjennom følgende steg for å representere en virksomhet (kunde) mot et Nav API, se også utfyllende informasjon fra Digitaliseringsdirektoratet:

1. Leverandør avtaler med Nav at de ønsker tilgang til API-et (tilgang til scope).
2. Nav gir leverandøren tilgang til scope for API-et.
3. Leverandørens kunde logger seg inn i Altinn Autorisasjon og delegerer tilgang til leverandøren. Leverandøren har med det fått fullmakt til å representere kunden.
4. Leverandøren autentiserer seg mot Maskinporten på vegne av kunde.
5. Maskinporten utsteder et Maskinporten-token dersom leverandør har gyldig fullmakt til å representere kunden.
6. Leverandør legger Maskinporten-tokenet ved i kall av Navs API. Tokenet identifiserer leverandøren som kaller API-et og kunde som leverandøren representerer. Nav benytter tokenet til å verifisere at kallet er autorisert.

Slik fungerer det med Systembruker

Systembruker er en ny type bruker i Altinn som lar virksomheten gi fullmakter til en upersonlig bruker, slik at den kan løse oppgaver på vegne av virksomheten. For mer informasjon se Systembruker for virksomheter.

Når en tjenesteeier (i dette tilfellet Nav) tilbyr et API som støtter bruk av systembruker så definerer tjenesteeier hvilke tilgangsregler som gjelder i Altinn Autorisasjon. For å kunne benytte API-et på vegne av kunder så må leverandør gå gjennom følgende steg, se også utfyllende informasjon fra Digitaliseringsdirektoratet på systembruker:

1. Leverandør avtaler med Nav at de ønsker tilgang til API-et (tilgang til scope).
2. Nav gir leverandøren tilgang til scope for API-et.
3. Leverandøren oppretter et system i systemregister (forvaltet av Digitaliseringsdirektoratet) med tilstrekkelige rettigheter til å ta i bruk Navs API. Se hvordan registrere system.
4. Leverandøren oppretter en systembruker per kunde for systemet.
5. Kunden godkjenner opprettelsen av systembruker som leverandøren skal benytte for å opptre på vegne av dem i Altinn Autorisasjon. Leverandøren har med det fått fullmakt til å representere kunden.
6. Leverandøren autentiserer seg mot Maskinporten med systembrukeren.
7. Maskinporten utsteder et Maskinporten-token dersom systembrukeren har gyldig fullmakt til å representere kunden.
8. Leverandør legger Maskinporten-tokenet ved i kall av Navs API. Tokenet identifiserer leverandøren som kaller API-et og kunde som leverandøren representerer. Nav benytter tokenet til å verifisere at kallet er autorisert.

Inntil videre vil veiledning på test gis av det teamet i Nav som eier et bestemt API.

Henvendelser som gjelder et spesifikt API, skal rettes direkte til API‑eier, se Nav API-oversikt. Andre typer henvendelser kan sendes til: ekstern.datautveksling@nav.no