Department of Motor Vehicles Check
The Jumio Department of Motor Vehicles (DMV) check is used to validate that a US driver’s license or ID card issued by the DMV is valid.
Supported Credentials
The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.
Details
| Key | Type | Mandatory | Description |
|---|---|---|---|
| firstName | string | Yes | First name of the subject. |
| middleName | string | No | Middle name of the subject. |
| lastName | string | Yes | Last name of the subject. |
| dateOfBirth | string | Yes | Date of Birth in yyyy-MM-dd format only |
| address.line1 | string | Yes | Address line 1 (Street address) |
| address.line2 | string | No | Address line 2 (Apartment, Suite, etc.) |
| address.city | string | Yes | City of residence as it appears on the Id. |
| address.postalCode | string | Yes | Postal or zip code. |
| address.subdivision | string | Yes | State name can be provided here. See Supported States. |
| address.country | string | Yes | country should be ISO Alpha 3 Code only |
| id.idNumber | string | Yes | number for ID being provided |
| id.issuingDate | string | No | in YYYY-MM-DD format only |
| id.expiryDate | string | No | in YYYY-MM-DD format only |
| id.type | string | Yes | only possible values are: DRIVING_LICENSE, PERMIT, ID_CARD |
Example Prepared Data Body
{
"firstName": "J****",
"middleName": "J****",
"lastName": "****h",
"dateOfBirth": "1972-**-1*",
"address": {
"line1": "***** SW Address Ln",
"postalCode": "9***1",
"city": "****",
"subdivision": "OR",
"country": "USA"
},
"id": {
"idNumber": "0*****812",
"type": "DRIVING_LICENSE",
"issuingDate": "20**-01-**",
"expiryDate": "20**-01-**"
}
}
Response
Response data is available for transactions that include the risk signal. For information on transaction data see this.
"drivingLicenseVerification": [
{
"id": "bd91fa85-8ef8-42d2-a064-954a30c10ed6",
"credentials": [
{
"id": "51c426f0-3e34-4c62-a552-85a73e9d52de",
"category": "DATA"
}
],
"decision": {
"type": "WARNING",
"details": {
"label": "ALERT"
}
},
"data": {
"nameMatch": "MATCH",
"firstNameMatch": "MATCH",
"lastNameMatch": "MATCH",
"middleNameMatch": "MATCH",
"addressMatch": "NOT_MATCH",
"addressLine1Match": "NOT_MATCH",
"addressLine2Match": "NOT_MATCH",
"cityMatch": "MATCH",
"stateMatch": "MATCH",
"zipCodeMatch": "MATCH",
"dobMatch": "MATCH",
"idNumberMatch": "MATCH",
"expiryDateMatch": "MATCH",
"issuingDateMatch": "MATCH"
},
}
Decision Details Labels
| Decision Type | Label | Description |
|---|---|---|
| PASSED | OK | Provided data matches DMV data. |
| REJECTED | DENY | Provided data does not match DMV data. |
| WARNING | ALERT | Provided data partially matches DMV data. |
| NOT_EXECUTED | UNSUPPORTED_COUNTRY | Provided address.country value is not supported. Must be USA. |
| NOT_EXECUTED | UNSUPPORTED_STATE | Provided address.subdivision value is not supported. Must be a USA state listed below. |
| NOT_EXECUTED | TECHNICAL_ERROR | Verify the provided data is correct and retry, or contact Support. |
Data
Fields include
| Key | Possible Values | Description |
|---|---|---|
| nameMatch | MATCH, NOT_MATCH | First and last name both match. |
| firstNameMatch | MATCH, NOT_MATCH | First name matches. |
| lastNameMatch | MATCH, NOT_MATCH | Last name matches. |
| middleNameMatch | MATCH, NOT_MATCH | Middle name matches. |
| addressMatch | MATCH, NOT_MATCH | All address values match. |
| addressLine1Match | MATCH, NOT_MATCH | Line1 address value matches. |
| addressLine2Match | MATCH, NOT_MATCH | Line2 address value matches. |
| cityMatch | MATCH, NOT_MATCH | City address value matches. |
| stateMatch | MATCH, NOT_MATCH | State address value matches. |
| zipCodeMatch | MATCH, NOT_MATCH | Postal code address value matches. |
| dobMatch | MATCH, NOT_MATCH | Date of birth matches. |
| idNumberMatch | MATCH, NOT_MATCH | The number of the license, permit, or ID card matches. |
| expiryDateMatch | MATCH, NOT_MATCH | Expiration date matches. |
| issuingDateMatch | MATCH, NOT_MATCH | Issue date matches. |
Supported States
The following states are supported by our DMV check today. Currently, this is available in the USA only.
States include
| State | Abbrv Code |
|---|---|
| ALABAMA | AL |
| ARKANSAS | AR |
| ARIZONA | AZ |
| COLORADO | CO |
| CONNECTICUT | CT |
| DISTRICT OF COLUMBIA | DC |
| DELAWARE | DE |
| FLORIDA | FL |
| GEORGIA | GA |
| HAWAII | HI |
| IOWA | IA |
| IDAHO | ID |
| ILLINOIS | IL |
| INDIANA | IN |
| KANSAS | KS |
| KENTUCKY | KY |
| MASSACHUSETTS | MA |
| MARYLAND | MD |
| MAINE | ME |
| MICHIGAN | MI |
| MISSOURI | MO |
| MISSISSIPPI | MS |
| MONTANA | MT |
| NORTH CAROLINA | NC |
| NORTH DAKOTA | ND |
| NEBRASKA | NE |
| NEW JERSEY | NJ |
| NEW MEXICO | NM |
| NEVADA | NV |
| OHIO | OH |
| OREGON | OR |
| RHODE ISLAND | RI |
| SOUTH DAKOTA | SD |
| TENNESSEE | TN |
| TEXAS | TX |
| VIRGINIA | VA |
| VERMONT | VT |
| WASHINGTON | WA |
| WISCONSIN | WI |
| WEST VIRGINIA | WV |
| WYOMING | WY |