Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Credential types

A credential type identifies the schema and the meaning of a set of claims. In the mso_mdoc format, the docType field names the credential type. In the SD-JWT VC format, the vct claim names the credential type. For the definition of the formats, see Credential formats.

This page describes the three credential types that are relevant to age verification, and the claims of each type.

How the verifier selects a type

The credential verifier does not hold a fixed list of allowed credential types. It verifies the type that the operator requests, provided the issuer certificate chains to a trusted issuer CA.

The operator names the requested type in one of two ways.

  • A full DCQL query in the dcql_query field of the transaction request. The query sets meta.doctype_value for mso_mdoc and meta.vct_values for SD-JWT VC.
  • A shorthand in the credential_type field of the transaction request. The verifier accepts proof-of-age, mdl, and national-id, and builds a default query for that type.

For the request fields, see Request parameters. For the query structure, see DCQL queries.

Mobile driver’s license (mDL)

The mobile driver’s license is a digital driving licence. The type uses the mso_mdoc format only. The 4th Driving Licence Regulation requires the ISO/IEC 18013-5 data model, so an mDL must not use the SD-JWT VC format.

PropertyValue
docTypeorg.iso.18013.5.1.mDL
Namespaceorg.iso.18013.5.1
Formatmso_mdoc
StandardISO/IEC 18013-5

The mDL supports the age attributes age_over_18, age_over_21, and age_over_NN for age verification. These attributes are optional.

mDL attributes

The table below lists the attributes of the org.iso.18013.5.1 namespace.

Attribute identifierDescriptionPresenceEncoding
family_nameCurrent family name or surnameMandatorytstr, UTF-8, maximum 150 chars
given_nameCurrent first name, including middle namesMandatorytstr
birth_dateDate of birthMandatoryfull-date, RFC 8943, tag 1004
portraitFacial image of the holderMandatorybstr, JPEG, ISO 19794-5
issue_dateDate of issuanceMandatorytdate or full-date
expiry_dateDate of expiryMandatorytdate or full-date
issuing_authorityAuthority that issued the documentMandatorytstr
issuing_countryCountry code, ISO 3166-1 alpha-2Mandatorytstr
document_numberUnique document identifierOptionaltstr
driving_privilegesVehicle categories and restrictionsMandatoryComplex type
un_distinguishing_signUN distinguishing sign of the issuing countryOptionaltstr
administrative_numberAdministrative number for the documentOptionaltstr
sexSex, 0 unknown, 1 male, 2 female, 9 not applicableOptionaluint
heightHeight in centimetresOptionaluint
weightWeight in kilogramsOptionaluint
eye_colourEye colourOptionaltstr
hair_colourHair colourOptionaltstr
birth_placePlace of birthOptionaltstr
resident_addressCurrent addressOptionaltstr
resident_cityCity of residenceOptionaltstr
resident_stateState or province of residenceOptionaltstr
resident_postal_codePostal codeOptionaltstr
resident_countryCountry of residence, ISO 3166-1 alpha-2Optionaltstr
age_over_18Whether the holder is over 18Optionalbool
age_over_21Whether the holder is over 21Optionalbool
age_over_NNWhether the holder is over NN yearsOptionalbool
age_in_yearsAge in yearsOptionaluint
age_birth_yearYear of birthOptionaluint
nationalityNationalityOptionaltstr

The driving_privileges attribute is an array with the following structure.

driving_privileges = [ * DrivingPrivilege ]

DrivingPrivilege = {
  "vehicle_category_code": tstr,
  ? "issue_date": full-date,
  ? "expiry_date": full-date,
  ? "codes": [ * Code ]
}

Code = {
  "code": tstr,
  ? "sign": tstr,
  ? "value": tstr
}

EUDI person identification data (PID)

Person identification data is the EU digital identity credential. The PID is available in both formats. The attributes are defined in Commission Implementing Regulation (CIR) 2024/2977 and the EU ARF PID Rulebook.

PropertyValue
docTypeeu.europa.ec.eudi.pid.1
Namespaceeu.europa.ec.eudi.pid.1
vcturn:eudi:pid:1
Formatsmso_mdoc and dc+sd-jwt
StandardCIR 2024/2977, EU ARF PID Rulebook

Mandatory attributes

Data identifierISO attribute idSD-JWT claimDescriptionEncoding (ISO)Encoding (SD-JWT)
family_namefamily_namefamily_nameCurrent surnametstrstring
given_namegiven_namegiven_nameCurrent first and middle nameststrstring
birth_datebirth_datebirthdateDate of birth, YYYY-MM-DDfull-datestring, ISO 8601-1
birth_placeplace_of_birthplace_of_birthPlace of birthplace_of_birthJSON object
nationalitynationalitynationalitiesNationality, ISO 3166-1 alpha-2nationalitiesarray of strings

Optional attributes

Data identifierSD-JWT claimDescriptionEncoding (ISO)Encoding (SD-JWT)
resident_addressaddress.formattedFull current addresststrstring
resident_countryaddress.countryCountry of residencetstrstring
resident_stateaddress.regionState or provincetstrstring
resident_cityaddress.localityCity or towntstrstring
resident_postal_codeaddress.postal_codePostal codetstrstring
resident_streetaddress.street_addressStreet nametstrstring
resident_house_numberaddress.house_numberHouse numbertstrstring
personal_administrative_numberpersonal_administrative_numberUnique PID numbertstrstring
portraitpictureFacial image, JPEG, ISO 19794-5bstrdata URL, base64
family_name_birthbirth_family_nameSurname at birthtstrstring
given_name_birthbirth_given_nameFirst name at birthtstrstring
sexsexSex, 0 to 9, see ISO 5218uintnumber
email_addressemailEmail address, RFC 5322tstrstring
mobile_phone_numberphone_numberMobile phone with country codetstrstring

Mandatory metadata

Data identifierSD-JWT claimDescription
expiry_datedate_of_expiryAdministrative expiry date
issuing_authorityissuing_authorityIssuing authority name
issuing_countryissuing_countryIssuing country, ISO 3166-1 alpha-2

Optional metadata

Data identifierSD-JWT claimDescription
document_numberdocument_numberPID document number
issuing_jurisdictionissuing_jurisdictionJurisdiction, ISO 3166-2
issuance_datedate_of_issuanceDate of issuance

The place_of_birth and nationalities attributes have the following structure in the mso_mdoc format.

place_of_birth = {
  ? "country": tstr,   ; ISO 3166-1 alpha-2 country code
  ? "region": tstr,    ; state, province, or district
  ? "locality": tstr   ; municipality, city, town, or village
}
; At least one of country, region, or locality must be present.

nationalities = [ + CountryCode ]
CountryCode = tstr     ; ISO 3166-1 alpha-2 country code

Important

The PID does not carry age attributes. The EU ARF PID Rulebook removed age_over_18 and age_over_21 in version 1.1, in line with CIR 2024/2977. For age verification, use an mDL or a Proof of Age attestation.

EU Age Verification proof of age

The proof of age attestation is the dedicated credential of the EU Age Verification Profile. The attestation carries one claim, age_over_18. The attestation holds no identity data.

PropertyValue
docTypeeu.europa.ec.av.1
Namespaceeu.europa.ec.av.1
Formatmso_mdoc only
StandardEU Age Verification Profile

The table below lists the attributes of the eu.europa.ec.av.1 namespace.

Attribute identifierDescriptionPresenceEncoding
age_over_18Whether the holder is over 18Mandatorybool

The proof of age attestation uses the following protocols.

StepProtocolDetail
IssuanceOpenID for Verifiable Credential IssuanceCredential configuration id proof_of_age
Presentation, primaryW3C Digital Credentials APIISO/IEC 18013-7 Annex C
Presentation, fallbackOpenID4VP with response_mode=direct_postAnnex A

A DCQL query that requests this attestation has the following form.

{
  "credentials": [
    {
      "id": "proof_of_age",
      "format": "mso_mdoc",
      "meta": { "doctype_value": "eu.europa.ec.av.1" },
      "claims": [{ "path": ["eu.europa.ec.av.1", "age_over_18"] }]
    }
  ]
}

Other credential types

The verifier accepts other credential types when the operator configures them. Any credential whose issuer chains to a trusted CA is verified, provided the DCQL query requests its docType or vct. For example, the relying-party example in typescript/demo-webapp/ also configures a Health ID credential, which uses the SD-JWT VC format. To request a type that is not one of the three above, supply a full dcql_query in the transaction request.