Name Lookup

A name verification service that checks for salacious, incomplete, or randomly typed characters in a name.

Compatible Cases

Icon 1

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.

Property NameTypeOptional/MandatoryNotes
NameQueryStringMandatory*Default field used for matching, can be blank if Forename/MiddleNames/Surname used instead
ForenameStringOptionalUsed when NameQuery is not specified
MiddleNamesStringOptionalUsed when NameQuery is not specified
SurnameStringOptionalUsed when NameQuery is not specified

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:

PropertyValue
HaltTriggeredFalse
ServiceTransactionResultSuccess
ServiceInterpretResultPass
ServiceTransactionResultMessage"This call was generated using sandbox mode"
ValidationResultNotApplicable

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:

PropertyValue
HaltTriggeredFalse
ServiceTransactionResultSuccess
ServiceInterpretResultInconclusive
ServiceTransactionResultMessage"This call was generated using sandbox mode"
ValidationResultNotApplicable

For all other name queries:

An empty, non-null IDCheckNameLookupResult will be returned.

The corresponding IDCheckNameLookupResult will show the following properties:

PropertyValue
HaltTriggeredFalse
ServiceTransactionResultSuccess
ServiceInterpretResultPass
ServiceTransactionResultMessage"This call was generated using sandbox mode"
ValidationResultNotApplicable

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


Language
Authorization
Header
Click Try It! to start a request and see the response here!