Publisert - 02.11.2026

UserInfo-endepunktet

UserInfo-endepunktet kan brukes for å motta claim om en bruker. Se spesifikasjonen for flere detaljer.

UserInfo-endepunktet er tilgjengelig i HelseID på stien /connect/userinfo, relatert til navnet på tjeneren. For eksempel:

https://helseid-sts.test.nhn.no/connect/userinfo

Endepunktet kan brukes både av en klient og av et API.

⚠️  Bruk av UserInfo-endepunktet

I de fleste tilfellene er ikke bruken av dette endepunktet nødvendig, ettersom den eneste spesifikke informasjonen om brukeren som blir sendt i responsen er detaljer angående brukerens autorisasjon(er) i Helsepersonellregisteret. Hvis programvaren ikke behøver denne informasjonen, vil bruken av Scopes være tilstrekkelig, både for klienter og API-er.

Kall til UserInfo-endepunktet

Programvaren må sende ved et gyldig Access-token i kallet:

GET https://helseid-sts.nhn.no/connect/userinfo
Authorization: Bearer <access_token>

Hvis klienten din bruker et DPoP-token, kan du likevel bruke dette som et Bearer-token mot UserInfo-endepunktet.

For at programvaren skal få en gyldig respons tilbake, må Access-tokenet inneholde enten helseid://scopes/hpr/hpr_number-scopet eller helseid://claims/hpr/hpr_number-claimet.

Respons fra UserInfo-endepunktet

Responsen er strukturert som et JSON-objekt. Dette objektet vil inneholde claims som beskriver brukeren. Særlig gjelder dette helseid://claims/hpr/hpr_details-claimet, som vil inneholde ekstra detaljer som omhandler brukerens autorisasjon(er) i Helsepersonellregisteret, hvis en slik autorisasjon finnes for brukeren.

Listen approvals inneholder bare brukerens gjeldende godkjenninger. Utløpte og suspenderte godkjenninger er ikke med, og responsen har ingen felt for status eller gyldighet. Hvis brukeren ikke har noen gjeldende godkjenninger, er listen tom.11

Eksempel på en respons:

{
    "userinfo_issued_at": 1714715867,
    "helseid://claims/hpr/hpr_details": {
        "approvals": [
            {
                "profession": "LE",
                "authorization": {
                    "value": "1",
                    "description": "Autorisasjon"
                },
                "requisition_rights": [
                    {
                        "value": "1",
                        "description": "Full rekvisisjonsrett"
                    }
                ],
                "specialities": []
            }
        ],
        "hpr_number": 565505933
    },
    "sub": "PGzVzvP2JvlXV\u002B\u002BOJSJAQG5d99BH8QsikmxpdIAKSZk="
}

 Hvis du bruker Test-token-tjenesten

Test-token-tjenesten er kun for test-miljøet, og hvis du trenger Access-tokens, så vil UserInfo-endepunktet kun svare for Access-tokens som hører til en aktiv HelseID-sesjon. Tokens fra Test-token-tjenesten har ingen sesjon og blir avvist. Et API som kaller UserInfo-endepunktet kan derfor ikke testes med slike tokens. Det trengs en ekte innlogging, for eksempel via TestIDP.

Søk i Utviklerportalen

Søket er fullført!