Skip to content

🇺🇸 USA

🇺🇸 USA

Operations

eIDV

Request

The USA eIDV (electronic Identity Verification) service provides automated, remote identity verification for individuals within the United States. It utilizes a person's first name, last name, and date of birth to check against official records. The service returns a match score along with a detailed description of the verification outcome, enabling quick and reliable identity checks.

Security
API-Key
Bodyapplication/json
first_namestring, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$required

The first name of a person

Example:"Josh"
middle_namestring or null, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$

The middle name of a person

Example:"David"
last_namestring, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$required

The last name of a person

Example:"Coffey"
dobstring, (date)required

The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601

Example:"1976-02-21"
addressstring or null, [ 1 .. 50 ] characters

An address (a street name, a building number, and a unit number) of a person or a company

Example:"45 High Street, Flat 2A"
citystring or null, [ 1 .. 50 ] characters

A city or a town of a person or a company

Example:"London"
statestring or null, [ 1 .. 50 ] characters

A state of a person or a company

Example:null
postal_codestring or null, [ 1 .. 20 ] characters

A postal code (zip code, postcode) of a person or a company

Example:"SW1A 1AA"
phonestring or null, [ 1 .. 15 ] characters

The phone number of a person or a company

Example:"441172345678"
emailstring or null, (email), [ 1 .. 254 ] characters

The email address of a person or a company

Example:"josh.coffey@example.com"
ssnstring or null, [ 4 .. 9 ] characters

The US Social Security Number of a person (SSN). The value must be an unformatted string of digits, either 4 digits (partial) or exactly 9 digits (full). No dashes, spaces, or other characters are allowed

Example:"545180772"
drivers_licensestring or null, [ 7 .. 14 ] characters

The unique driver identification number issued by a US state or territory. It is a mix of numbers and letters, and its format is state-dependent

Example:"P620-7949"
{
  "first_name": "Josh",
  "middle_name": "David",
  "last_name": "Coffey",
  "dob": "1976-02-21",
  "address": "45 High Street, Flat 2A",
  "city": "London",
  "state": null,
  "postal_code": "SW1A 1AA",
  "phone": "441172345678",
  "email": "josh.coffey@example.com",
  "ssn": "545180772",
  "drivers_license": "P620-7949"
}

Responses

OK

The request was successful, and our system returned an expected response.

Bodyapplication/json
dataobject
Response
{
  "data": {
    "match_score": 80,
    "name_match": "NO_MATCH",
    "dob_match": "NO_MATCH",
    "address_match": "NO_MATCH",
    "city_match": "NO_MATCH",
    "state_match": "NO_MATCH",
    "postal_code_match": "NO_MATCH",
    "phone_match": "NO_MATCH",
    "email_match": "NO_MATCH",
    "ssn_match": "NO_MATCH",
    "drivers_license_match": "NO_MATCH"
  }
}