The userinfo endpoint may be used to retrieve additional information about an end user beyond what is contained in the ID Token. The end user in question is given by the sub value contained in the access token.

By including the supported scopes in the authorize request, the end user will be presented with consent dialogues (see User Experience) for the requested end user information. If consent is given, you'll be able to access the TINFO resource server by utilizing the userinfo endpoint to get the requested end user data by using the Access token as Bearer token.

Overview

Response elements

Userinfo returns signed responses in JWT format. The claims contained in the encoded JWT includes supported standard claims (see table below) along with the following additional claims:

Standard claims

Claim	Scope	Support	Consent	Comment
sub	(any)	Yes		Subject Identifier. Also contained in ID Token
name	profile	Yes		Common Name from associated BankID certificate. Also contained in ID Token
given_name	profile	Yes		First name part of the name claim. Also contained in ID Token
familiy_name	profile	Yes		Last name (surname) part of the name claim. Also contained in ID Token
middle_name	profile	No
nickname	profile	No
preferred_username	profile	No
profile	profile	No
picture	profile	No
website	profile	No
email	email	Yes	Consent required	Email is registered by end user themselves via consent dialogues after authentication
email_verified	email	No
gender	profile	No
birthdate	profile	Yes		Birthdate from associated BankID certificate. Also contained in ID Token
zoneinfo	profile	No
locale	profile	No
phone_number	phone	Yes	Consent required	Phone number is registered by end user themselves via consent dialogues after authentication
phone_number_verified	phone	No
address	address	Yes	Consent required	JSON structure with sub-elements as shown below Address is registered by the end user themselves via consent dialogues after authentication
address:formatted	address	Yes	(see address)	Full address string
address:street_address	address	Yes	(see address)	Street address
address:locality	address	Yes	(see address)	Norwegian "poststed"
address:region	address	No	(see address)
address:postal_code	address	Yes	(see address)	Norwegian "postnummer"
address:country	address	No	(see address)
updated_at	profile	Yes		Epoch time for latest update of any of the supported TINFO data elements
nnin	nnin	Yes	Consent required	Norwegian National Identity Number

Example

Response

{
  "iss": "https://userinfo.current.bankid.no",
  "sub": "9578-6000-4-00001",
  "aud": "oidc-testclient",
  "name": "Ola Normann",
  "given_name": "Ola",
  "family_name": "Normann",
  "updated_at": 1519992419860,
  "email": "normann@example.org",
  "birthdate": "110286",
  "phone_number": "95871775",
  "address": {
    "formatted": "Veien 311\nOslo 0772",
    "street_address": "Veien 311",
    "locality": "0772",
    "postal_code": "Oslo"
  }
}