Validate Lead

Validate multiple contact fields, from two full names, with a single API call - name, address, phone and email. Validates the relationship between all components of a lead to verify the identity of the underlying individual.ValidateComposite returns the most extensively parsed data for the subject's name, address, and phone number information.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

HTTP Headers

The "content-type" in the HTTP header must be set to "application/json", otherwise an HTTP 400 Bad Request response will be returned.

NameResult

If request contains two names then two separate sets of names and gender are returned.

Field nameTypeDescription
FirstName1stringParsed first name
MiddleName1stringParsed middle name
LastName1stringParsed last name
FirstName2stringParsed first name
MiddleName2stringParsed middle name
LastName2stringParsed last name
CodesarrayParsing and validation results. See Status codes

AddressResult

Field nameTypeDescription
AddressstringFormatted full street address
AddressRangestringParsed address range
StreetNamestringParsed street name
SuffixstringParsed street suffix. i.e. St, Ave, Rd
PostDirectionstringParsed street post direction
CitystringParsed and corrected city
CountyNamestringCounty name
CountyFipsstringCounty FIP code
Statestring2 digit state abbreviation
Zipstring5 digit postal code
Zip4string4 digit Zip extension
CountryCodestringCountry code
CarrierRoutestringCarrier route number
CongressionalDistrictstringCongressional district number
TimeZonestringTime zone description
TimeZoneCodestringTime zone code
AddressTypeCodestringAddress type code
CodesarrayResult

PhoneResult

Field nameTypeDescription
AreaCodestringArea code
Prefixstring3 digit prefix
Suffixstring4 digit suffix
CitystringCity
StatestringState
CountryCodestringCountry code
CountyFipsstringCounty Fips code
CountyNamestringCounty name
DistancestringDistance from input postal code
MsastringMetropolitan Statistical Area
PmsastringPrimary Metropolitan Statistical Area
TimeZonestringTime zone
TimeZoneCodestringTime zone code
LineTypestringSee Line Type.
CodesarrayParsing and validation results. See Status codes.
ConnectionScorenumberProvides a connection confidence score for the input phone number as a percentage (0 to 1) of how often this phone is used. Values below 35% are considered to be low use phone numbers or may have no usage data. Only present if verifyconnectionstatus=true and a P20 code is returned.

EmailResult

Field nameTypeDescription
UserstringParsed username
DomainstringParsed domain name
CodesarrayParsing and validation results. See Status codes.

ValidateComposite Status Codes

This section lists the following types of status codes for the ValidateComposite method.

CodeDescription
C1First name, last name, postal address and phone number match in Source 1
C2Last name, postal address and phone number match in Source 1
C3Last name and phone number match in Source 1
C5Postal address and phone number match in Source 1
C11First name, last name, postal address and phone number match in Source 2
C12Last name, postal address and phone number match in Source 2
C13Last name and phone number match in Source 2
C15Postal address and phone number match in Source 2
C16First name, last name, postal address and phone number match in Source 3
C17Last name, postal address and phone number match in Source 3
C18Last name and phone number match in Source 3
C19Postal address and phone number match in Source 3

HTTP Error Messages

Click to see a complete listing of error messages and codes.

Path Params
string
required

License key issued by customer support. Click here for a trial key

Query Params
string
required

First name of search subject.

string
required

Last name or full name. System automatically combines firstname and lastname fields and then parses the resulting value.

string
required

Full street address including house number and street name.

string

City of input address. Optional, if postalcode is used.

string

State of input address. Optional, if postalcode is used.

string

5- or 9-digit postal code of input address. Optional, if city and state are used.

string

7- or 10 digit phone number

boolean
required

Indicates whether the telephone number should be matched against the daily updated directory assistance database, which is a strong indication of connectivity.

string

Email address of prospect

boolean
required

Verifies current email address delivery status by contacting the ISP’s email server and checking for existence of the mailbox.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json