US DL Verification API

11 min

Introduction

Signzy's driving license verification API instantly verifies the details of the person by providing the driver's license number, last name, date of birth, and state. The driver's license is one of the key identities which can be used for individual verification in any customer onboarding journey.

How to use the API

You will require an authorization token to use this API. This authorization token will be generated by Signzy for you and will be used in each API call. Please contact [email protected] for this.

API Input Guidelines

You will need to pass on the following information to start the verification process.

Driver's license number
Last name
Date of birth in YYYY-DD-MM format
State

Sample cURL

Production

Preproduction

curl --location --request POST 'https://api.signzy.app/api/v3/us-api/dl-verification' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "driversLicenseNumber": "<drivers license number>",
    "lastName": "<last name>",
    "dateOfBirth": "<date of birth>",
    "state": "<state name>",
    "expirationDate": "<expiration date>",
    "issueDate": "<issue date>",
    "confidenceThreshold": <confidence threshold>
}'

curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/us-api/dl-verification' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "driversLicenseNumber": "<drivers license number>",
    "lastName": "<last name>",
    "dateOfBirth": "<date of birth>",
    "state": "<state name>",
    "expirationDate": "<expiration date>",
    "issueDate": "<issue date>",
    "confidenceThreshold": <confidence threshold>
}'

Input Parameters

PARAMETER NAME	MANDATORY	DESCRIPTION
Content-Type	true	application/json
Authorization	true	Authorization token
driversLicenseNumber	true	Drivers License Number
lastName	true	Last Name of the DL Holder
dateOfBirth	true	Date of Birth of the DL Holder in YYYY-DD-MM format
state	true	The US state of the DL (eg: Maine)
expirationDate	false	Expiration Date of the DL in YYYY-DD-MM format
issueDate	false	Issue Date of the DL in YYYY-DD-MM format
confidenceThreshold	false	Confidence threshold to match the degree of verification (default: 0.80)

API Output

The response from this API contains the status of your request, the confidence score for this result, and also the final result of the verification process. The "hasErrors" field shows whether the data verification was successful or not.

Sample Response

{
    "result": {
        "requestStatus": "Completed",
        "confidence": 0.5,
        "hasErrors": true,
        "hasWarnings": false,
        "result": "Validation Successful"
    }
}

Response Parameter

PARAMETER NAME	DESCRIPTION
result	This parameter contains the actual output.
result.requestStatus	It gives the status of the verification.
result.confidence	Confidence in the match found
result.hasErrors	true/false
result.hasWarnings	true/false
result.result	Validation Successful / Validation Failed. If the confidence is greater than the confidence threshold then it is successful, otherwise failed.

Sample Error

{
    "message": "Invalid authentication credentials"
}

Response Parameter

PARAMETER NAME	DESCRIPTION
error	This parameter contains the error.
error.name	the name of the error
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 - same as HTTP status

Points to keep in mind

The verification process cannot be done for the following US States -

Alaska
Louisiana
Minnesota
New Hampshire
Nevada
New York
Oklahoma
South Carolina
Utah

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].