Hent egenandelsfritakstatus¶

Endepunkt for å sjekke om en borger er fritatt fra å betale egenandel for en gitt tjenestetype på en gitt dato.

Fritak gjelder hvis borgeren har innvilget frikort for det kalenderåret tjenestedatoen faller i. For tjenester levert av apotek eller bandasjist gjelder i tillegg at minstepensjonister er fritatt.

Reservasjon: Borgere kan reservere seg mot den automatiske frikortordningen. For borgere med reservasjon vil tjenesten alltid svare negativt (harEgenandelsfritak: false). Borgere med reservasjon må selv fremvise frikortbevis.

Endepunkt¶

Request¶

Headers¶

Request body¶

Request-body sendes som en JWE-kryptert streng. Kryptering er påkrevd fordi request-innholdet avslører at en borger har mottatt en bestemt type helsetjeneste på en gitt dato, noe som utgjør sensitive personopplysninger. Helsedirektoratets policy krever ende-til-ende-kryptering av sensitive data på offentlig sky. TLS alene er ikke tilstrekkelig da data ellers ender i klartekst ved TLS-terminering. Se JWE-kryptering for detaljer om kryptering.

Det dekrypterte innholdet i JWE-payloaden skal være følgende JSON:

{
  "borgerIdent": "12345678901",
  "tjenestetypeKode": "LE",
  "tjenestedato": "2026-06-15"
}

Felter i request¶

Response¶

HTTP-statuskoder¶

Response body (200 OK)¶

Responsen returneres som ukryptert JSON med Content-Type: application/json.

{
  "harEgenandelsfritak": true
}

Response headers¶

Feilresponser¶

Ved feil (4xx/5xx) returneres en JSON-body med følgende struktur:

{
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "feilkode": "UGYLDIG_REQUEST",
  "melding": "Request-body er ikke gyldig JWE Compact Serialization",
  "timestamp": "1716283200000"
}

Feilkoder¶

Caching og duplikate oppslag¶

For å unngå unødvendige kall til tjenesten skal det i utgangspunktet kun sendes én spørring per borger per døgn per behandler/tjenesteyter.

Et duplikat-oppslag er her et oppslag en behandler/tjenesteyter gjør som er identisk med et oppslag samme behandler har gjort tidligere samme døgn — altså samme fødselsnummer, tjenestedato og tjenestetypekode. For eksempel at en lege gjør flere oppslag samme døgn med samme fødselsnummer, dato og tjenestetypekode.

Store mengder duplikate oppslag skaper unødvendig ekstrabelastning på tjenesten og er med på å skape driftsutfordringer som kunne vært unngått. Det forventes at journalsystemet er i stand til å ta vare på kall gjort siste døgn, slik at det ikke kjøres flere identiske oppslag innenfor samme døgn.

Eksempler¶

Request¶

POST /api/frikortsporring/helseid/v1 HTTP/1.1
Host: frikortbifrost.nav.no
Authorization: DPoP eyJhbGciOiJSUzI1NiIsInR5cCI6ImF0K2p3dCJ9...
DPoP: eyJ0eXAiOiJkcG9wK2p3dCIsImFsZyI6IkVTMjU2Iiw...
Content-Type: application/jose
Correlation-Id: 3fa85f64-5717-4562-b3fc-2c963f66afa6

eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiZnJpa29ydGJpZnJvc3QtZW5jLTIwMjYwMzEyLTEifQ...

Response — borger er fritatt¶

HTTP/1.1 200 OK
Content-Type: application/json
Correlation-Id: 3fa85f64-5717-4562-b3fc-2c963f66afa6

{
  "harEgenandelsfritak": true
}

Response — borger er ikke fritatt¶

HTTP/1.1 200 OK
Content-Type: application/json
Correlation-Id: 3fa85f64-5717-4562-b3fc-2c963f66afa6

{
  "harEgenandelsfritak": false
}

Response — ugyldig request¶

HTTP/1.1 400 Bad Request
Content-Type: application/json
Correlation-Id: 3fa85f64-5717-4562-b3fc-2c963f66afa6

{
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "feilkode": "UGYLDIG_REQUEST",
  "melding": "Valideringsfeil: 'tjenestetypeKode' er ikke en gyldig kode",
  "timestamp": "1716283200000"
}

Response — autentisering feilet¶

HTTP/1.1 401 Unauthorized
Content-Type: application/json
Correlation-Id: 3fa85f64-5717-4562-b3fc-2c963f66afa6

{
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "feilkode": "AUTENTISERING_FEILET",
  "melding": "JWT-token er ugyldig eller utløpt",
  "timestamp": "1716283200000"
}

Testpersoner¶

Vi har et sett med testpersoner som kan brukes i testmiljøet. Disse personene har ulike kombinasjoner av fritaksstatus og identtype (FNR/DNR) for å teste forskjellige scenarier.