All categories ​ > ​ ​Smart policies and risk ​ > ​ ​Checks and data providers ​ > ​   Configuring LexisNexis InstantID

Configuring LexisNexis InstantID

Updated 3 months ago by Ainsley

LexisNexis is a data provider that offers InstantID, which you can use to run the Electronic identity check on individuals residing in the United States.

Unlike other data providers for the Electronic identity check, LexisNexis InstantID does not return the number of sources used to match the individual. This means that, a "2+2" result can never be achieved. See the descriptions below to learn what causes the check to return a partial match or pass.

How it works

This is the default behaviour of the Electronic identity check, without any configuration options applied (i.e. address is not a required field, identity number is not a required field, and date of birth is not a required field). To learn how this default behaviour changes when options are applied, see Configuration options.

This check is performed by searching the individual's details (name, address, and either date of birth or social security number) in the sources supplied by LexisNexis InstantID.

The check returns a partial match when when either of these conditions are true:

  1. The individual's full name and address are matched in one source from LexisNexis InstantID.
  2. The individual's full name, date of birth, and social security number are matched in one source from LexisNexis InstantID.

If the conditions are not met for a partial match, the check fails.

If the individual's profile doesn't have data for the required fields, the check returns an error.

If the individual's address or national identity number has a country other than the US, the check returns an error.

With the default configuration, the check never passes. You can apply the Pass check on 1+1 result configuration option if you would like the check to pass instead of returning a partial match.
If the individual has multiple addresses, the most recent address is used. If no dates are provided, the address is selected at random.

Configuration options

You can use the following configuration options:

  • Pass check on 1+1 result: When this option is selected, the check passes rather than returning a partial match. When this option is on, a partial match is never returned.
  • Use the most recent previous address if the result isn't a 2+2: When this option is selected, the individual's most recent address is used to run the check the first time. If the check fails, the check is run again automatically using the next most recent address. The check is only run again automatically once.
When this option is selected, any time the check is run again automatically, you are charged for the second check.
If the addresses provided on the individual's profile do not include dates, the addresses used for this check are selected at random.
  • Address is one of the required fields: When this option is selected, the individual's address is required to return a partial match. This means the check only returns a partial match when the individual's full name and address are matched in one source.
  • Identity number is one of the required fields: When this option is selected, the individual's social security number is required for the check to return a partial match.

    This means the check only returns a partial match when either of the following conditions are met:

    1) The individual's full name, date of birth, and social security number are matched in one source.

    2) The individual's full name and social security number are matched in one source.
  • DOB is one of the required fields: When this option is selected, the individual's date of birth is required for the check to return a partial match.

    This means the check only returns a partial match when either of the following conditions are met:

    1) The individual's full name, date of birth, and social security number are matched in one source.

    2) The individual's full name and date of birth are matched in one source.
When the configuration options for Address is one of the required fields, Identity number is one of the required fields and DOB is one of the required fields are both used, the check only returns a partial match when the individual's full name, address, social security number, and date of birth are matched in one source.

What we'll need

Let us know that you'd like to add a variant of the Electronic identity check with LexisNexis InstantID and which configuration options you'd like to use. We'll set it up for you.

To complete the configuration, we'll need:

  • Your LexisNexis InstantID username and password so we can add it to our set up.
  • You to ask LexisNexis to whitelist our IP address for your account: 35.195.138.186

For help whitelisting the IP address or getting your LexisNexis InstantID login details, please contact your LexisNexis account manager.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

  1. Does the check return a partial match? To run the test, create any individual profile with an address in the United States, and run the check variant. If the check returns a partial match, it's working as expected. Note that if you're using the Pass check on 1+1 result configuration option, the check variant is working as expected if the check passes.
  2. Does the check fail when the conditions are not met for a partial match? To run the test, create any individual profile with an address in the United States and "FAIL" as a given name or the surname (e.g. "Alex FAIL Wheeler"), and run the check variant. If the check fails, it's working as expected.
The test words are not case-sensitive.

Required and optional profile fields

These are the profile details searched in LexisNexis's sources:

Name

Description

First name(s) (personal_details.name.given_names)

Required

The individual's first and, if applicable, middle names.

Surname (personal_details.name.family name)

Required

The individual's last name.

Addresses (address_history)

Optional

Note that although this field is optional, if you're using the Address is one of the required fields configuration option and an address is not included in the profile, the check will fail.

The individual's address history.

National identity number (personal_details.national_identity_number)

Required

This is optional if the individual's date of birth is provided and the Identity number is one of the required fields configuration option is not used.

The individual's social security number.

Note that the national identity issuer must be the United States.

Date of birth (personal_details.dob)

Required

This is optional if the individual's national identity number is provided and the DOB is one of the required fields configuration option is not used.

The individual's date of birth.

Phone number (personal_details.national_identity_number)

Optional

The individual's phone number.

Note that the phone number must not include the country code and must not have any formatting applied.

For example, the phone number (+1) 202-555-0111 should be entered as 2025550111.

Gender (personal_details.gender)

Optional

The individual's gender. Leave unspecified for non-binary genders.

How did we do?

Powered by HelpDocs (opens in a new tab)