Skip to content

eIDV

Request

Use this endpoint to verify the identity of a person in the United States without documents. Our system compares the data that you send with records in identity databases and returns an overall match score and a match result for each field.

First name, last name, and date of birth are required. Other fields are optional. Each optional field that you send gets its own match result and can increase the score.

Our system does not approve or decline the check. Compare score with your own threshold. KYCAID forms use a default threshold of 70.

Each request is charged.

Security
API-Key
Bodyapplication/jsonrequired
first_namestring, <= 64 charactersrequired
Example:"Jane"
middle_namestring, <= 64 characters

Optional

Example:"Marie"
last_namestring, <= 64 charactersrequired
Example:"Sample"
dobstring, (date)required

Date of birth in the YYYY-MM-DD format

Example:"1985-04-12"
ssnstring^\d{9}$|^\d{4}$

Optional. Social Security Number: all 9 digits or the last 4 digits. Digits only, without dashes or spaces

Example:"987654321"
addressstring, <= 50 characters

Optional. Street address (building number, street name, and unit number)

Example:"100 Example Street, Apt 2"
citystring, <= 50 characters

Optional

Example:"Springfield"
statestring, <= 50 characters

Optional. Two-letter state code

Example:"IL"
postal_codestring, <= 20 characters

Optional. ZIP code

Example:"62701"
phonestring, <= 15 characters

Optional. Phone number, digits only

Example:"15555550123"
emailstring, (email), <= 254 characters

Optional

Example:"jane.sample@example.com"
drivers_licensestring, <= 16 characters

Optional. Driver’s license number. The format depends on the issuing state

Example:"S5300000"
{
  "first_name": "Jane",
  "last_name": "Sample",
  "dob": "1985-04-12"
}

Responses

OK

The request was successful, and our system returned the result of the check.

Bodyapplication/json
validationobject
dataobject
Response
{
  "validation": {
    "valid": true
  },
  "data": {
    "score": 100,
    "name_match_type": "MATCH",
    "dob_match_type": "MATCH",
    "address_match_type": null,
    "city_match_type": null,
    "state_match_type": null,
    "postal_code_match_type": null,
    "phone_match_type": null,
    "email_match_type": null,
    "ssn_match_type": null,
    "drivers_license_match_type": null
  }
}