Validate multiple contact fields, from two full names, with a single API call - name, address, phone, email, and IP address. 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.

🚧

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.

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.

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