Hopp til innhold

Veiledning for utviklere

Altinn API

Altinn 3 forklart: hva plattformen er etter at Altinn 2 ble lagt ned, hvordan en virksomhet får tilgang selv, og hva Apier tilbyr i stedet.

Apier formidler ikke Altinn. Kjernen i Apier er selskapsfakta og signaturrett for AI-agenter, med kilde og tidspunkt på hvert svar, hentet fra Brønnøysundregistrene. Les mer om Apier.

Hva er Altinn-API-et?

Altinn er den felles plattformen for digital dialog mellom næringsliv og offentlig sektor i Norge, driftet av Digdir. Altinn 3 er den nåværende generasjonen: skjemaer og meldinger går gjennom Instances-API-et, og hvem som får gjøre hva styres av Altinn Autorisasjon med roller, tilgangspakker og delegeringer. Et sluttbrukersystem (for eksempel et regnskapssystem) handler i Altinn på vegne av en virksomhet gjennom en systembruker virksomheten selv har opprettet og godkjent.

Digdir la ned Altinn 2 19. juni 2026. Altinn 2-roller ble ikke automatisk til Altinn 3-tilgangspakker, så virksomheter som integrerte mot Altinn 2 måtte sette opp tilgangene på nytt. Tilordningen fra rolle til tilgangspakke står på Altinn 3-overgangen.

Hvordan passer dette inn i en større integrasjon? Hvordan integrerer jeg med Altinn 3? går gjennom stegene en virksomhet tar selv.

Guidene bak denne siden:

Hvordan får en virksomhet tilgang til Altinn 3?

Tre deler, alle i virksomhetens eget navn:

  1. Maskinporten. En klient hos Digdir med virksomhetssertifikat eller registrert nøkkel, og scopene etaten gir. Se Maskinporten API.
  2. Systemregister og systembruker. Systemleverandøren registrerer systemet sitt i Altinn sitt systemregister og godtar bruksvilkårene for sluttbrukersystemleverandører. Hver kunde oppretter og godkjenner deretter en systembruker for systemet i Altinn, med de tilgangspakkene systemet trenger, og kan trekke den tilbake.
  3. Tilgangspakker og roller. Hva systembrukeren eller en innlogget person får gjøre, følger av tilgangspakkene og rollene i Altinn Autorisasjon. Disse opplysningene tilhører Altinn og virksomheten; bruksvilkårene tillater bare bruk til offentlig oppgaveløsning.

Hva gjør Apier ikke med Altinn?

Apier formidler ikke Altinn-tilgang, oppretter ingen systembrukere, sjekker ingen delegeringer eller tilgangspakker, og sender ikke inn skjemaer. Bruksvilkårene for sluttbrukersystemleverandører i Altinn (versjon 1.0, 2025) avgrenser API-ene og dataene til offentlig oppgaveløsning, og Altinn Servicedesk bekreftet skriftlig 21. oktober 2026, etter juridisk vurdering, at opplysninger fra Altinn Autorisasjon ikke kan brukes som grunnlag for en kommersiell tjeneste, med eller uten systembruker. Endepunktene og MCP-verktøyene som før tilbød dette, svarer nå 410 CAPABILITY_WITHDRAWN og peker videre til signaturrett.

Hva tilbyr Apier i stedet?

Maskinverifiserbar norsk signaturrett og selskapsfakta fra Brønnøysundregistrene, åpne data under Norsk lisens for offentlige data (NLOD): selskapets registrerte signaturregler, kodet som rollekombinasjoner med klausulteksten ordrett, status, roller, regnskapstall, og pliktene og fristene som støttelag. I tillegg et oppslag uten autentisering i den offentlige tilordningen fra Altinn 2-rolle til Altinn 3-tilgangspakke, som er dokumentasjon fra Digdir og ikke data om noen virksomhet.

# Zero-auth sandbox: synthetic fixture org 999999999.
# Registry data and coded signing authority; no Altinn data.
curl https://www.apier.no/api/v1/sandbox/public/company/999999999/authority
# Zero-auth: the static Altinn 2 role to Altinn 3 access-package map
# (public Digdir documentation, not data about any organisation).
curl "https://www.apier.no/api/v1/tools/altinn-migration?altinn2_code=A0079"

Hvor finner jeg API-referansen?

Hvordan håndterer jeg feil?

Alle feil fra Apier følger Compliance Explainer-formatet med error_code, en norsk forklaring og konkrete fix_steps, uten at interne detaljer lekker ut. Et kall til et endepunkt som er trukket tilbake svarer 410 CAPABILITY_WITHDRAWN med forklaring på norsk og engelsk; et selskap som ikke finnes gir 404 NOT_FOUND. Hver respons bærer en X-Correlation-ID du kan oppgi til support.

Vanlige spørsmål

Hva er forskjellen på Altinn 2 og Altinn 3?

Altinn er Norges felles plattform for digital dialog mellom næringsliv og offentlig sektor. Altinn 2 er den eldre generasjonen (SOAP-tjenester, rollebasert autorisasjon); Altinn 3 er den nåværende generasjonen (REST og Instances-API-et, tilgangspakkebasert autorisasjon, og systembrukere for tilgang mellom maskiner). Digdir la ned Altinn 2 19. juni 2026, og etter det er Altinn 3 det eneste Altinn-API-et. Eldre Altinn 2-endepunkter svarer ikke lenger.

Trenger jeg en systembruker og Maskinporten for å bruke Apier?

Nei. Det Apier tilbyr, status, roller og kodet signaturrett for et selskap, er åpne registerdata fra Brønnøysundregistrene og trenger verken Altinn-tilgang, systembruker eller Maskinporten. Integrasjonen din sender én Bearer-API-nøkkel til Apier. Skal virksomheten din handle i Altinn i eget navn, settes systembruker og Maskinporten opp direkte hos Digdir og i Altinn; Apier formidler ikke det.

Hva skjedde med Altinn 2-integrasjonen min 19. juni 2026?

Den sluttet å virke den dagen. Altinn 2-roller ble ikke automatisk overført til Altinn 3-tilgangspakker, så hver virksomhet trengte nye tilganger i Altinn 3. Apier eksponerer tilordningen fra Altinn 2-rolle til Altinn 3-tilgangspakke som et oppslag uten autentisering på /api/v1/tools/altinn-migration; det er offentlig dokumentasjon fra Digdir, ikke data om noen enkelt virksomhet. Forbeholdet om at én Altinn 2-rolle ofte deles på tvers av flere Altinn 3-pakker er dekket på /no/altinn3-overgang.

Kan jeg sende inn til Altinn 3 gjennom Apier?

Nei. Innsending til Altinn er en handling i virksomhetens eget navn: den gjøres av virksomhetens eget sluttbrukersystem med en systembruker virksomheten selv har godkjent, eller av en person med rett rolle som logger inn selv. Altinn Servicedesk bekreftet skriftlig 21. oktober 2026, etter juridisk vurdering, at opplysninger fra Altinn Autorisasjon ikke kan brukes som grunnlag for en kommersiell tjeneste, med eller uten systembruker. Apier sender derfor ikke inn, lager ikke prøveinnsendinger og sjekker ikke delegeringer; de gamle endepunktene for dette svarer 410 CAPABILITY_WITHDRAWN.

Hvordan prøver jeg Apier uten legitimasjon?

Disse selskapsendepunktene har et sandkassespeil uten autentisering under /api/v1/sandbox/public/ mot den syntetiske testorganisasjonen 999999999: summary, authority, context, obligations, deadlines, accounts, audit og verify. Responsformen matcher produksjon, så du kan koble opp og teste klienten din før du oppretter en nøkkel. Sandkassen inneholder ingen Altinn-data: den speiler registerdata og signaturrett. /sandbox/examples-siden lister cURL-eksempler du kan kopiere for summary, context og obligations.

Les mer

Kom i gang

Sandkassen kan kjøres med curl uten registrering, og dokumentasjonen dekker endepunktene, scopes og hva som ikke tilbys.