Claim Sets

Request specific identity data from mDL holders using predefined or custom claim sets.

When creating a verification session, you specify which claims (data fields) you want to request from the mDL holder. Following the principle of data minimization, you should only request the claims necessary for your use case.

Predefined Claim Sets

The SDK provides predefined claim sets for common verification scenarios. These make it easy to request the right data without remembering individual claim names.

Age Verification

Identity Verification

Driving Privileges

Custom Claims

For specific requirements, you can request individual claims by name:

Available Claims (ISO 18013-5)

The following claims are defined by the ISO 18013-5 standard and may be available in mDL credentials:

Identity Claims

Claim	Swift Type	Description
`family_name`	String	Family name / last name
`given_name`	String	Given name / first name
`birth_date`	Date	Date of birth
`portrait`	Data	Facial photo (JPEG data)

Age Verification Claims

Claim	Swift Type	Description
`age_over_18`	Bool	Is holder 18 years or older
`age_over_21`	Bool	Is holder 21 years or older

Document Claims

Claim	Swift Type	Description
`document_number`	String	License/document number
`issue_date`	Date	Document issue date
`expiry_date`	Date	Document expiration date
`issuing_authority`	String	Issuing authority name

Address Claims

Claim	Swift Type	Description
`resident_address`	String	Street address
`resident_city`	String	City
`resident_state`	String	State/province code
`resident_postal_code`	String	ZIP/postal code
`resident_country`	String	Country code

Driving Claims

Claim	Swift Type	Description
`driving_privileges`	[[String: ClaimValue]]	License classes and restrictions

AAMVA-Specific Claims

Claim	Swift Type	Description
`aamva.domestic_vehicle_class`	String	Vehicle class code
`aamva.DHS_compliance`	String	REAL ID compliance
`aamva.organ_donor`	Bool	Organ donor indicator

Accessing Claim Values

The MDLClaims object provides strongly-typed access to common claims:

Generic Claim Access

ClaimValue Type

The SDK uses a type-safe ClaimValue enum for claim data:

Best Practices

Data Minimization: Only request the claims you actually need. This improves user trust, reduces privacy risk, and may increase consent rates from mDL holders.

Next Steps

Session Management – Handle session lifecycle and state
Error Handling – Handle errors gracefully