Name Lookup

Compatible Cases

About the service

IDCheckNameLookupService is a name verification service. It checks that the name is not salacious, incomplete or randomly typed characters.

Product Code: W2-DATA-SALACIOUS_NAME-023

Does this service leave a credit search Footprint? No

Request

The following properties pertain to this service.

Validation

It is mandatory to provide at least one of the above name fields.

• NameQuery will take precedence over Forename, MiddleNames, and Surname.
• If Name Query has no value, a combination of Forename, MiddleNames, and Surname will be used instead.

After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.

Response

ID Check Name Lookup example response:

"idCheckNameLookupResult": {  
  "validationResultReason": "The name is not salacious"
}

Sandbox

To use sandbox the following example request can be used.

Remember to include the W2 provided API key in the Authorization Header.

{  
    "Bundle": "IDCheckNameLookup",  
    "Data": {  
        "NameQuery": "John Smith"  
    },  
    "Options": {  
        "Sandbox": "true"  
    },  
    "ClientReference": "your-client-reference"  
}

If the Sandbox query option is set to "true" the following entries shown in Sandbox Examples below will be returned in the ServiceResult

Sandbox Examples

Example Response for "John Smith":

"idCheckNameLookupResult": {  
  "validationResultReason": "The name is not salacious"  
}

The corresponding ServiceTransactions will show the following properties:

Example Response for "Mickey Mouse":

"idCheckNameLookupResult": {  
  "validationResultReason": "The name is flagged against our blacklist of known salacious words"  
}

The corresponding ServiceTransactions will show the following properties:

Example Response for "aabbccddee":

"idCheckNameLookupResult": {  
	"validationResultReason": "The name appears to have been entered by hitting random keys"  
}

The corresponding ServiceTransactions will show the following properties:

For all other name queries:

An empty, non-null IDCheckNameLookupResult will be returned.

The corresponding IDCheckNameLookupResult will show the following properties:

Docs not making sense? Please contact us so we can fix them: [email protected] :)