US DL Verification

Introduction

US Driver's License Verification is a solution set to streamline the process of verifying the authenticity of driver's licenses within the United States. Leveraging data from the American Association of Motor Vehicle Administrators (AAMVA), this API will perform comprehensive checks by comparing multiple parameters from the AAMVA's database against user/client provided information. This verification process ensures the high level of accuracy and security. In a world where trust and accuracy matter, our API ensures that the driver's license details you receive are not just valid but also meticulously verified.

US Driver's License

A United States Driver's License, is an official document issued by state governments within the United States that authorizes individuals to operate motor vehicles legally on the country's roadways. It serves as both a form of personal identification and a permit to drive a car, motorcycle, or other types of motor vehicles, depending on the specific type of driver's license.

Here are some key points to understand about the U.S. Driver's License:

1. Legal Requirement: In the United States, it is typically a legal requirement to possess a valid driver's license in order to drive a motor vehicle on public roads. Driving without a valid license can result in legal penalties.

2. State-Based: Driver's licenses in the U.S. are issued by individual states and territories. Each state has its own Department of Motor Vehicles (DMV) or equivalent agency responsible for issuing and regulating driver's licenses.

3. Types of Driver's Licenses: There are various types of driver's licenses, including a regular driver's license for operating standard passenger vehicles, commercial driver's licenses (CDL) for driving commercial vehicles like trucks and buses, and learner's permits for those who are learning to drive.

4. Identification: Driver's licenses also serve as a form of personal identification. They typically include the driver's photograph, full legal name, date of birth, and residential address.

5. Age Restrictions: Some states issue driver's licenses to individuals as young as 16 for regular driving, while others have minimum age requirements for specific types of licenses, such as motorcycle endorsements.

6. Expiry: Driver's licenses have expiration dates, typically requiring renewal every few years. The expiration date can vary from state to state.

7. Driving Records: Each state maintains a driving record for license holders, which includes information on traffic violations, accidents, and other driving-related incidents.

8. Interstate Recognition: U.S. driver's licenses are generally recognized and accepted throughout the country. This means that you can typically use your home state's license when traveling or moving to a different state.

What is AAMVA

The American Association of Motor Vehicle Administrators (AAMVA) is a non-profit organization that serves as a central authority and resource for motor vehicle and driver licensing agencies across the United States and Canada. At present 41 USA States are members of AAMVA. AAMVA facilitates cooperation and collaboration among these agencies to improve and standardize various aspects of motor vehicle administration and regulation. Here's a brief context about AAMVA:

Membership: AAMVA's membership includes all U.S. states, Canadian provinces, the District of Columbia, and U.S. territories. This extensive membership makes it a key organization for promoting uniformity in motor vehicle and driver licensing practices.

Functions: AAMVA provides a range of services, including research, information sharing, best practices, and the development of standards and specifications for driver licensing, vehicle registration, and other related functions.

Data Exchange: AAMVA plays a vital role in standardizing data sharing and information exchange among member jurisdictions. This is particularly important for activities such as driver's license verification and motor vehicle record sharing.

Overview of US DL Verification API

US Driver's License Verification API offers a reliable and efficient way to verify driver's license details, enhancing data accuracy and security across a wide range of applications. The API provides real-time verification of driver's license details, offering a robust set of verification metrics and seamless integration capabilities.

API Applications

B2B (Business-to-Business) Applications:

Insurance Companies: Insurance providers can use this API to validate driver's license details when customers apply for auto insurance.

Car Rental Agencies: Car rental companies can integrate this API to confirm the validity of driver's licenses before renting vehicles.

Employers and Background Check Services: Employers and background check services can utilize this API for verifying driver's license information.

Transportation and Logistics Companies: Businesses in the transportation and logistics sector can employ this API to verify the driver's licenses of their delivery personnel.

B2C (Business-to-Consumer) Applications:

Consumer Auto Insurance: Individuals seeking auto insurance can use this API to verify their driver's license details during the online application process.

Ride-Sharing and Carpooling Services: Ride-sharing and carpooling platforms can incorporate this API to validate the driver's licenses of drivers.

Peer-to-Peer Car Rentals: Platforms that facilitate peer-to-peer car rentals can offer drivers the option to verify their licenses through this API.

Job Seekers: Individuals applying for jobs that involve driving, such as delivery or transportation roles, can use this API to validate their driver's license information.

API Details

You must first login before sending the request. The authorization header in the request must include the access token obtained from the login API call.

Need to pass the following information. Providing personFullname, nationalId, personDob is mandatory.

firstName(required)

middleName

lastName(required)

dateOfBirth

sex

address

addressLine2

city

state(required)

zip

ssn

driverLicenseNumber(required)

driverLicenseIssueDate

driverLicenseExpirationDate

confidenceThreshold

Sample cURL

Pre-Production

Production

curl --location 'https://api-preproduction.signzy.app/api/v3/dl-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: <token>' \
--data '{
    "firstName": <string>,
    "middleName": <string>,
    "lastName": <string>,
    "dateOfBirth": <yyyy-mm-dd>,
    "sex": <M or F>,
    "address": <string>,
    "addressLine2": <string>,
    "city": <string>,
    "state": <string>,
    "zip": <string>,
    "ssn": <string>,
    "driverLicenseNumber": <string>,
    "driverLicenseIssueDate": <yyyy-mm-dd>,
    "driverLicenseExpirationDate": <yyyy-mm-dd>,
    "confidenceThreshold": <number>
}'

curl --location 'https://api.signzy.us/api/v3/dl-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: <token>' \
--data '{
    "firstName": <string>,
    "middleName": <string>,
    "lastName": <string>,
    "dateOfBirth": <yyyy-mm-dd>,
    "sex": <M or F>,
    "address": <string>,
    "addressLine2": <string>,
    "city": <string>,
    "state": <string>,
    "zip": <string>,
    "ssn": <string>,
    "driverLicenseNumber": <string>,
    "driverLicenseIssueDate": <yyyy-mm-dd>,
    "driverLicenseExpirationDate": <yyyy-mm-dd>,
    "confidenceThreshold": <number>
}'

Request Body Parameters

Parameter	Data Type	Required	Description
firstName	string	Yes	Required First name of the individual.
middleName	string	No	Optional Middle name of the individual.
lastName	string	Yes	Required Last name of the individual.
dateOfBirth	string	No	Optional Date of birth of the individual (ISO 8601) (yyyy-mm-dd format).
sex	string	No	Optional Gender of the individual(only M or F values allowed).
address	string	No	Optional Street address of the individual.
addressLine2	string	No	Optional Address line 2 (if applicable).
city	string	No	Optional City of residence.
state	string	Yes	Required State of residence. Should be of two letter state code(list provided above).
zip	string	No	Optional ZIP code of the location.
ssn	string	No	Optional Social Security Number.
driverLicenseNumber	string	Yes	Required Driver's license number.
driverLicenseIssueDate	string	No	Optional Driver's license issue date (ISO 8601) (yyyy-mm-dd format).
driverLicenseExpirationDate	string	No	Optional Driver's license expiration date (ISO 8601) (yyyy-mm-dd format).
confidenceThreshold	number	No	Optional Confidence threshold provided by the user. Only numeric values from 0.7 to 1 allowed(if not passed, default value of 0.7 will be added).

Sample Response

{
    "result": {
        "driverLicenseVerificationResult": {
            "documentCategoryMatch": "true",
            "personLastNameExactMatch": "true",
            "personLastNameFuzzyPrimaryMatch": "",
            "personLastNameFuzzyAlternateMatch": "",
            "personFirstNameExactMatch": "true",
            "personFirstNameFuzzyPrimaryMatch": "",
            "personFirstNameFuzzyAlternateMatch": "",
            "personMiddleNameExactMatch": "false",
            "personMiddleNameFuzzyPrimaryMatch": "false",
            "personMiddleNameFuzzyAlternateMatch": "false",
            "personMiddleInitialMatch": "false",
            "personBirthDateMatch": "true",
            "driverLicenseIssueDateMatch": "true",
            "driverLicenseExpirationDateMatch": "true",
            "driverLicenseNumberMatch": "true",
            "addressLine1Match": "true",
            "addressLine2Match": "",
            "addressCityMatch": "true",
            "addressStateCodeMatch": "true",
            "addressZIP5Match": "true",
            "addressZIP4Match": "",
            "personSexCodeMatch": "true",
            "addressLine1FuzzyMatch": ""
        },
        "confidenceThreshold": 0.7,
        "confidenceScore": 1,
        "validationResult": "Validation Successful"
    }
}

Response Body parameters

Parameter	Data Type	Description
driverLicenseVerificationResult	Object	Verification details for the driver's license
confidenceThreshold	String	Confidence Threshold from request( assigned as 0.7 by default if not provided).
confidenceScore	Number	Confidence Score calculated based on driverLicenseVerificationResult details. Value may vary from 0 to 1.
validationResult	Number	Final validation result for DL Verification. (Value is "Validation Successful" if confidenceScore is greater than or equal to threshold, else "Validation Failed").

driverLicenseVerificationResult Parameters

Name	Type	Description
documentCategoryMatch	string	Indicates if the document category matches.
personLastNameExactMatch	string	Indicates if the person's last name is an exact match.
personLastNameFuzzyPrimaryMatch	string	Indicates if the person's last name is a fuzzy primary match.
personLastNameFuzzyAlternateMatch	string	Indicates if the person's last name is a fuzzy alternate match.
personFirstNameExactMatch	string	Provides the information if Indicates if the person's first name is an exact match.
personFirstNameFuzzyPrimaryMatch	string	Indicates if the person's first name is a fuzzy primary match.
personFirstNameFuzzyAlternateMatch	string	Indicates if the person's first name is a fuzzy alternate match.
personMiddleNameExactMatch	string	Indicates if the person's middle name is an exact match.
personMiddleNameFuzzyPrimaryMatch	string	Indicates if the person's middle name is a fuzzy primary match.
personMiddleNameFuzzyAlternateMatch	string	Based on a check against Indicates if the person's middle name is a fuzzy alternate match.
personMiddleInitialMatch	string	Indicates if the person's middle initial is a match.
personBirthDateMatch	number	Indicates if the person's birth.
driverLicenseIssueDateMatch	string	Indicates if the driver's license issue date matches.
driverLicenseExpirationDateMatch	string	Indicates if the driver's license expiration date matches.
driverLicenseNumberMatch	string	Indicates if the driver's license number matches.
addressLine1Match	string	Indicates if address line 1 matches.
addressLine2Match	string	Indicates if address line 2 matches.
addressCityMatch	string	Indicates if the address city matches.
addressStateCodeMatch	string	Indicates if the address state code matches.
addressZIP5Match	string	Indicates if the ZIP5 of the address matches.
addressZIP4Match	string	Indicates if the ZIP4 of the address matches.
personSexCodeMatch	string	Indicates if the person's gender code matches(M or F).
addressLine1FuzzyMatch	string	Indicates if address line 1 matches.

driverLicenseVerificationResult Parameters Values

For all the parameters in driverLicenseVerificationResult, their values will be "true"(if validation for corresponding request param is successful), "false"(if validation for corresponding request param is failure) or ""(if the corresponding request param is either not provided from the client or has invalid/corrupt value).

Confidence Score Logic

Our validation process checks specific details like names, license numbers, and dates you provide. Each detail has a different importance. The API checks specific details to calculate a validation score namely: ['driverLicenseNumber', 'firstName', 'lastName', 'stateCode', 'personDob', 'driverLicenseIssueDate', 'driverLicenseExpirationDate'] Weight Importance: Each detail has a different level of importance in the check. For instance:

'driverLicenseNumber' matching is most crucial (given the highest weight of 0.50).

Exact matches in 'firstName' or 'lastName' are important too (weighted at 0.10 each), while close matches count a bit less (0.075).

'state' match, birthdate, and specific dates on the license carry moderate weight (0.10).

Dates like 'driverLicenseIssueDate' and 'driverLicenseExpirationDate' are less critical (0.05).

Scoring System: The API assigns scores to each detail based on whether they match exactly or closely. These scores are added up, and if the total reaches 1, it means everything matched perfectly. If the total is slightly less than 1, it implies some details didn't match as well. Validation Threshold: The goal is to achieve a combined score of 0.70 or higher. This benchmark ensures that most parts match well. If the total score meets or exceeds 0.70, the API considers it a successful validation. If it falls below, it indicates some discrepancies.

In general, we suggest keeping the passing score at 0.70 or higher to ensure a strong verification. If you're unsure, we can leave it as is, and we'll use 0.70 as the default passing score for the verification.

States Supported by DMV:

State Abbreviation	State Name
AL	Alabama
AZ	Arizona
AR	Arkansas
CO	Colorado
CT	Connecticut
FL	Florida
GA	Georgia
ID	Idaho
IL	Illinois
IN	Indiana
IA	Iowa
KS	Kanas
KY	Kentucky
LA	Louisiana
ME	Maine
MD	Maryland
MA	Massachusetts
MI	Michigan
MN	Minnesota
MS	Mississippi
MO	Missouri
MT	Montana
NE	Nebraska
NJ	New Jersey
NM	New Mexico
NC	North Carolina
ND	North Dakota
OH	Ohio
OR	Oregon
RI	Rhode Island
SC	South Carolina
SD	South Dakota
TN	Tennessee
TX	Texas
VT	Vermont
VA	Virginia
WA	Washington
WV	West Virginia
WI	Wisconsin
WY	Wyoming

States Not Supported by DMV:

State Abbreviation	State Name
AK	Alaska
CA	California
DE	Delaware
DC	District of Columbia
HI	Hawaii
NV	Nevada
NH	New Hampshire
NY	New York
OK	Oklahoma
PA	Pennsylvania
UT	Utah

Sample Error

{
  "error": {
    "name": "error",
    "message": "state is not allowed to be empty",
    "status": 400,
    "reason": "VALIDATION_ERROR",
    "type": "Bad Request",
    "statusCode": "400"
  }
}

Error Response Parameters

Parameter	Description
error	This parameter contains the error.
error.name	the error name.
error.message	the error message.
error.status	Status of the api
error.reason	Reason for error
error.type	Type of the error
error.statusCode	Request Status code from Signzy

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!