Attributes reference

You use Smart-ID to verify the end-user's identity and obtain relevant personal details about them. This page summarises user information you can request and receive for the different protocols.

Since we recommend either using OIDC or the Authentication REST API, we only show information for those two protocols below.

OIDC scopes and claims

You can use the following scopes to request user information from an end-user using Smart-ID:

Scope	OIDC Claim	Example	Description
idp-id	idp_id	49002171234	Personal identifier set by the identity provider.
nin	nin	49002171234	National identification number / personal code number of the end-user, consisting of 11 digits.
	nin_type	CIVIL	Type of national identity number.
	nin_issuing_country	EE	Issuing country code of the national identity: LT (Lithuania), LV (Latvia) or EE (Estonia).
profile	name	LAURA JANSONS	Full name of the end-user.
	given_name	LAURA	First name of the end-user.
	family_name	JANSONS	Surname of the end-user.

Response example

The response example below only shows the section with the user information claims.

Scope: openid profile idp idp-id nin

{
    "idp": "sk-smartid",
    "idp_id": "49002171234",
    "name": "LAURA JANSONS",
    "family_name": "JANSONS",
    "given_name": "LAURA",
    "nin": "49002171234",
    "nin_type": "CIVIL",
    "nin_issuing_country": "EE",
}

Authentication REST API attributes

The Signicat Authentication REST API supports the following request and response attributes for Smart-ID:

Attributes	Example	Description
subject	2ULSP7fTILirGvQKmJzSX7z3pY6NIYcK4xYnu3hqIO8=	Personal identifier set by the identity provider.
nin	49002171234	National identification number / personal code number of the end-user, consisting of 11 digits.
name	LAURA JANSONS	Full name of the end-user.
given_name	LAURA	First name of the end-user.
family_name	JANSONS	Surname of the end-user.

Response example

Here is a section of the response showing the user information attributes:

"subject": {
	"id": "2ULSP7fTILirGvQKmJzSX7z3pY6NIYcK4xYnu3hqIO8=",
	"idpId": "070770-905D",
	"name": "LAURA JANSONS",
	"firstName": "LAURA",
	"lastName": "JANSONS",
	"nin": {
		"value": "49002171234",
		"issuingCountry": "EE",
		"type": "CIVIL"
	},
}