United States of America
Credential type: Mobile Driver's License (mDL) Standard: ISO 18013-5 (proximity) / ISO 18013-7 (online/remote)
US mDLs are state-issued driving licenses provisioned into a device wallet and cryptographically signed by the issuing state DMV. Incode supports three wallets. All three expose the same attribute set with selective disclosure. In Dashboard, you configure which fields to request per flow from the ID Capture Module under Digital IDs > United States.
| Method | SDK ID |
|---|---|
| Apple Wallet | apple_wallet |
| Google Wallet | google_wallet |
| Samsung Wallet | samsung_wallet |
Available attributes
All attributes are selectable. Configure which attributes to request for each flow in the Dashboard.
| Attribute | ocrData field |
|---|---|
| Given name | name.givenName |
| Family name | name.paternalLastName |
| Date of birth | birthDate |
| Gender | gender |
| Height | height |
| Nationality | nationality |
| Age 18+ confirmation (no DOB shared) | ageOver18 |
| Age 21+ confirmation (no DOB shared) | ageOver21 |
| License number | documentNumber |
| Issue date | issuedAt |
| Expiry date | expireAt |
| Issuing country | issuingCountry |
| Issuing authority | issuingAuthority |
| Driving privileges | drivingPrivileges |
| Full address | address |
| City | addressFields.city |
| State / Province | addressFields.state |
| Postal code | addressFields.postalCode |
| Portrait photo | via /omni/get/images |
Attributes are returned via GET /omni/get/ocr-data/v2 under the ocrData object. Two fields identify the credential:
documentSubmissionMethod— alwaysIMPORTED_CREDENTIALfor digital ID sessionscredentialsProvider— identifies the specific wallet:apple_wallet,google_wallet, orsamsung_wallet
Selective disclosure and data minimization
Unlike physical document capture, mDL presentation is attribute-by-attribute. The wallet only releases the fields you explicitly request; anything not requested never leaves the device.
The Dashboard pre-selects all available attributes when you first enable a wallet method. Configure each flow to request only what you actually need.
Recommended attribute sets by use case
| Use case | Request |
|---|---|
| Age gate | ageOver18 or ageOver21 only — no DOB shared |
| Identity verification | name.givenName, name.paternalLastName, birthDate, portrait |
| KYC / account opening | Add documentNumber, issuedAt, expireAt, issuingAuthority |
| Address verification | Add addressFields.city, addressFields.state, addressFields.postalCode |
| Driving eligibility | Add drivingPrivileges |
height, nationality, gender, and drivingPrivileges should only be requested when directly relevant. Several US states with mDL programs restrict what relying parties may request; request the minimum your use case requires.
Provider registration
Incode guides you through the registration process and, where applicable, handles registration on your behalf. Contact your Incode Support representative to get started.
Updated about 17 hours ago
