United States

Social Security Number

We are able to verify a US person's identity based on their name and address first line, SSN (last 4 or full 9). To improve the result, you can also include date of birth of the user in your request.

Request:

{
    "template_id": "US_SSN",
    "user_data": {
        "first_name": "REQUIRED",
        "last_name": "REQUIRED",
        "date_of_birth": "OPTIONAL",
        "address": {
            "address_street_1": "REQUIRED",
            "address_street_2": "OPTIONAL",
            "address_city": "CONDITIONAL: required if zip code not present",
            "address_state": "CONDITIONAL: required if zip code not present",
            "address_zip_code": "CONDITIONAL: not required if city and state are present"
        },
        "identity": {
            "identity_number_type": "'SSN9' or 'SSN4'",
            "identity_number": "{{4_Digit_SSN or 9_Digit_SSN}}",
            "identity_country_code": "US"
        }
    }
}

Driver License

🚧

This API is set to be deprecated on 1st Oct' 23.

Customers can validate driver’s licenses and learner’s permits with government and proprietary data sources in 41 US states.

Driver’s License Verification validates the printed data fields from the driver’s license with government and proprietary data sources.

States that are not supported

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

Fields that are being validated

Data FieldAll states except CaliforniaCalifornia
Driver’s License Number
License Type (ie. Commercial)
Last Name
Date of Birth
Issue Date
Expiration Date
State

Request:

{
    "template_id": "US_DRIVER_LICENSE",
    "user_data": {
        "identity": {
            "identity_country_code": "US",
            "identity_number_type": "DRIVER_LICENSE",
            "identity_number": "{{DL_Number}}"
        },
        "last_name": "REQUIRED",
        "date_of_birth": "YYYY-MM-DD" // Required
    },
    "additional_info": [
        {
            "additional_info_type": "US_AAMVA",
            "additional_info_data": {
                "expiration_date": "YYYY-MM-DD", // Optional
                "issue_date": "YYYY-MM-DD", // Optional
                "state_code": "XX" //Required
            }
        }
    ]
}