Helsepersonellregisteret Offentlig API

Helsepersonellregisteret Offentlig API gjør offentlige data fra Helsepersonellregisteret (HPR) offentlig tilgjengelig og sikret med Maskinporten.

APIet er tilgjengelig på https://api.offentlig.hpr.nhn.no. Merk at vår Swagger-dokumentasjon ikke er deployet i produksjon, så du vil se en tom side når du besøker denne siden.

For å se Swagger-dokumentasjonen, besøk vårt testmiljø: https://api.offentlig.test.hpr.nhn.no/swagger/index.html

Brukertilgang og autorisering

For å få bruker-tilgang vil du trenge en token fra Maskinporten. For mer informasjon om å få denne token, se Maskinporten-dokumentasjonen(https://docs.digdir.no/docs/Maskinporten/maskinporten_overordnet.html).

For å få tilgang til grunnleggende policy for HPRs offentlige API, kan du gi deg selv tillatelse til scopet nhn:hpr/basic via Maskinportens Selvbetjeningsportal(Pass på å filtrere scopes etter scopes som er "Tilgjengelig for alle".). Dette er også hvor du lager din integrasjon og setter opp nøkler.

Miljø

Miljø URL
Test https://api.offentlig.test.hpr.nhn.no/
Prod https://api.offentlig.hpr.nhn.no/

Offentlige Endepunkter (nhn:hpr/basic)

HTTP Endepunkt Forklaring
GET /v1/personer/ Hent en person med HPR-nummer
GET /v1/personer Søk etter person med etternavn og fødselsdato

Utvidete Endepunkter (nhn:hpr/extended)

Inneholder ekstra data som krever autorisasjon fra Helsedirektoratet for å få tilgang. Om du ønsker tilgang til dette kan etterspørres via godkjenning@helsedir.no. Vær oppmerksom på at selv om din organisasjon tildeles det utvidete scopet, må det fortsatt manuelt legges til dine klientkonfigurasjoner.

HTTP Endepunkt Forklaring
GET /v1/personerutvidet/ Hent en person med HPR-nummer,
GET /v1/personerutvidet Søk etter person med etternavn og fødselsdato
POST /v1/personerutvidet Hent en person med fødselsnummer

FAQs

Hvordan får jeg logget på maskinportens selvbetjeningsportal med Organisasjonsnummer? Du må være er knyttet til et organisasjonsnummer gjennom Altinn for å få tilgang til maskinportens selvbetjeningsportal. En administrator for din organisasjon kan delegere dette til deg via https://info.altinn.no/

Jeg finner ikke det åpne scopet nhn:hpr/basic-scope Pass på å filtrere scopes etter scopes som er "Tilgjengelig for alle".

Jeg har blitt gitt tilgang til det utvidet scopet, men jeg får ikke laget tokens med dette scopet Selv om din organisasjon tildeles det utvidete scopet, må det fortsatt manuelt legges til dine klientkonfigurasjoner.