Person API

Person API gir informasjon om norske borgere for den norske offentlige helsesektoren.
API‑et vedlikeholdes av Norsk helsenett.

Data i API‑et er sammensatt fra flere kilder, der den primære kilden er Det nasjonale folkeregisteret ("Folkeregisteret").
Informasjonsmodellen i Person API‑et er et superset av Folkeregisterets informasjonsmodell.
Mer informasjon om Folkeregisterets informasjonsmodell finnes på norsk her:
Folkeregisterets informasjonsmodell

Se oversettelser for en liste over oversettelser fra norske termer som brukes i Folkeregisteret til engelske termer som brukes i Person API‑et.

Send tilbakemeldinger og spørsmål til utvikling-persontjenesten@nhn.no

OpenAPI spesifikasjon

See Person API

Versjonering

See Versjonering

Endringslogg

See Endringslogg

Syntetisk test data

Data i vårt testmiljø bruker syntetiske testdata fra Syntetisk folkeregister. For å bla gjennom de tilgjengelige dataene kan du logge inn via ID‑porten på Testnorge.

Autetntisering og autorisasjon

Dette API‑et bruker HelseID for autentisering og autorisering. For å bruke API‑et trenger du et gyldig HelseID‑token med riktig scope. Versjon 3 bruker DPoP for token‑utveksling. Du kan be om tilgang til Person‑API‑et via HelseID‑selvbetjeningsportalen.

I versjon 3 av Person API‑et er det to scopes tilgjengelige:

• FullAccess | Scope: nhn:hgd-persontjenesten-api/full-access

  Gir lesetilgang til all informasjon, tilsvarende autorisasjons‑pakken «public with legal basis» (lovbestemt myndighet). Inkluderer også tilgang til konfidensielle adresser.

• RestrictedAccess | Scope: nhn:hgd-persontjenesten-api/restricted-access

  Gir lesetilgang til all informasjon bortsett fra konfidensielle adresser og CCR‑informasjon.

  
  
  

Merk: Versjon 2 av Person‑API‑et vil bli slått av 15.04.2026 i produksjon og 12.03.2026 i TEST.
Versjon 2 bruker følgende scopes for å konsumere ressurser fra Person‑API‑et:

• ReadWithLegalBasis | Scope: nhn:hgd-persontjenesten-api/read-with-legal-basis

  Dette scopet gir lesetilgang til informasjon i autorisasjonspakken «public with legal basis» (også kalt lovbestemt myndighet).

  For versjon 0.5 var navnet nhn:hgd-persontjenesten-api/read

• ReadNoLegalBasis | Scope: nhn:hgd-persontjenesten-api/read-no-legal-basis

  Dette scopet gir lesetilgang til informasjon i den offentlige pakken «public without legal basis».

Kodeeksempler

Kodeeksempler som demonstrerer en API‑klient som henter et gyldig token fra HelseID og gjør forespørsler mot Person‑API‑et finnes her:

• Java
• .NET Core

Ansvarsfraskrivelse: Disse eksemplene er kun ment som referanse og vedlikeholdes ikke aktivt.
De bør brukes som inspirasjon snarere enn som produksjonsklare implementasjoner.