# eIDV

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.


Endpoint: POST /services/us/eidv
Version: 1.0
Security: your_api_key

## Request fields (application/json):

  - `first_name` (string,null)
    The first name of a person

  - `last_name` (string,null)
    The last name of a person

  - `dob` (string,null)
    The date of birth of a person, formatted according to ISO 8601

## Response 200 fields (application/json):

  - `data` (object)

  - `data.score` (integer,null)
    Overall identity match score

  - `data.score_descriptions` (array)
    The detailed description of matches for each parameter

  - `data.address_match_type` (string,null)
    The type of match found for the person’s address

- : The person’s address address has a total match against the record in the database
- : The person’s address address partially matches the record in the database
- : The person’s address address did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.name_match_type` (string,null)
    The type of match found for the person’s full name

- : The person’s full name address has a total match against the record in the database
- : The person’s full name address partially matches the record in the database
- : The person’s full name address did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.dob_match_type` (string,null)
    The type of match found for the person’s date of birth

- : The person’s date of birth address has a total match against the record in the database
- : The person’s date of birth address partially matches the record in the database
- : The person’s date of birth address did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.phone_match_type` (string,null)
    The type of match found for the person’s phone number

- : The person’s phone number address has a total match against the record in the database
- : The person’s phone number address partially matches the record in the database
- : The person’s phone number address did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.email_match_type` (string,null)
    The type of match found for the person’s email address

- : The person’s email address has a total match against the record in the database
- : The person’s email address partially matches the record in the database
- : The person’s email address did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.ssn_match_type` (string,null)
    The type of match found for the person’s Social Security Number (SSN)

- : The person’s SSN has a total match against the record in the database
- : The person’s SSN partially matches the record in the database
- : The person’s SSN did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.city_match_type` (string,null)
    The type of match found for the person’s city

- : The person’s city has a total match against the record in the database
- : The person’s city partially matches the record in the database
- : The person’s city did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.zip_match_type` (string,null)
    The type of match found for the person’s ZIP code

- : The person’s ZIP code has a total match against the record in the database
- : The person’s ZIP code partially matches the record in the database
- : The person’s ZIP code did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.state_match_type` (string,null)
    The type of match found for the person’s state

- : The person’s state has a total match against the record in the database
- : The person’s state partially matches the record in the database
- : The person’s state did not match a record in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", null

  - `data.driver_license_match_type` (string,null)
    The type of match found for the driver license

- : The driver license has a total match against the record in the database
- : The driver license partially matches the record in the database
- : The driver license did not match a record in the database
- :No driver license information was available in the database
    Enum: "MATCH", "PARTIAL_MATCH", "NO_MATCH", "NO_DL_AVAILABLE_ON_RECORD", null

## Response 400 fields (application/json):

  - `type` (string)
    Example: "bad_request"

  - `errors` (array)

## Response 500 fields (application/json):

  - `type` (string)
    Example: "internal_server"

  - `errors` (array)