Our Lead Validation service cross-validates, corrects and scores over 130 key data points to help your business more accurately identify quality leads for US and Canada. Works with leading CRM and marketing automation platforms.

This document defines the input, output, and behavior of the web services in LV.

Important Note!

Lead Validation cannot determine the complete validity of a lead 100% of the time. Often, unlisted phone numbers, cell phone numbers, very rare names, rural or new addresses, and the like will cause either neutral or negative shifts in a lead’s validity. LV provides a baseline guide of a lead’s quality that must be taken with serious consideration.

URL Endpoints

ValidateLead_V3 Inputs

NameTypeLengthDescription
FullNameString60The contact’s full name. e.g. Jane Doe
SalutationString10Salutation of the contact. Dr, Esq, Mr, Mrs etc
FirstNameString60First name of the contact. e.g. Jane
LastNameString60Last name of the contact. e.g. Doe
BusinessNameString60The contacts company. e.g. Service Objects
BusinessDomainString60Website domain associated with the business. e.g. serviceobjects.com
BusinessEINString60Represents the Company Tax Number. Used for Tax exempt checks for US leads.
Address1String60The address 1 of the contact or business address.
Address2String60The address 2 of the contact or business address.
Address3String60The address 3 of the contact or business address.
Address4String60The address 4 of the contact or business address.
Address5String60The address 5 of the contact or business address.
LocalityString60The city of the contact’s postal address.
AdminAreaString60The state of the contact’s postal address.
PostalCodeString20The zip code of the contact’s postal address.
CountryString60The country of the contact’s postal address. e.g. United States, US or USA
Phone1String20The contact’s primary phone number.
Phone2String20The contact’s secondary phone number.
EmailString60The contact’s email address.
IPAddressString45The contact’s IP address in IPv4. (IPv6 coming in a future release)
GenderString10Male, Female or Neutral
DateOfBirthString10The contact’s date of birth
UTCCaptureTimeString10The time the lead was submitted
OutputLanguageString20Language field indicating what language some of the output information will be.
TestType [1]String20The name of the type of validation you want to perform on this contact.
LicenseKeyString20Your license key to use the service. 
Sign up for a free trial key at 
https://www.serviceobjects.com/products/lead-validation-bundles/lead-verification

ValidateLead_V3 Outputs

NameTypeLengthValuesDescription
OverallCertaintystring3VariesA value that represents the overall certainty that the service provided on the lead. This value will range from 0 to 100.
OverallQualitystring10Reject, Review or AcceptA field indicating whether the lead should be rejected, reviewed or accepted
LeadTypestring10Residential, Business or UnknownIndicates the classification that the service made for the lead.
LeadCountrystring3VariesThe country associated with the lead, given as an ISO 2.
NoteCodesstringVariesEnumerated list of descriptive notes
NoteDescstringVariesDescriptions that correspond to the NoteCodes section
NameCertaintystring3VariesScore between 0 and 100 that indicates the probability that the given name is valid.
NameQualitystring10Reject, Review or AcceptA field indicating whether the given name should be rejected, reviewed or accepted.
FirstNamestring60VariesThe first name with diacritic characters.
LastNamestring60VariesThe last name with diacritic characters.
FirstNameCleanstring60VariesThe first name of the lead without diacritic characters.
LastNameCleanstring60VariesThe last name of the lead without diacritic characters.
NameNoteCodesstringVariesEnumerated list of codes indicating further information about the name field.
NameNotesDescstringVariesEnumerated list of descriptive notes that correspond to the NameNoteCodes field.
AddressCertaintystring3VariesScore between 0 and 100 that indicates the validity of the given address.
AddressQualitystring10Reject, Review or AcceptA field indicating whether the given address should be rejected, reviewed or accepted
Address1string60VariesThe validated Address line 1
Address2string60VariesThe validated Address line 2
Address3string60VariesThe validated Address line 3
Address4string60VariesThe validated Address line 4
Address5string60VariesThe validated Address line 5
AddressLocalitystring60VariesThe locality associated with the given input address. Usually corresponds to the city.
AddressAdminAreastring60VariesThe Admin Area tied with the input address. Usually corresponds to the State or Province.
AddressPostalCodestring20VariesThe Postal Code tied to the given input address.
AddressCountrystring60Varies2 Character ISO code for the country
AddressNoteCodesstringVariesEnumerated list of codes indicating additional information about the given address.
AddressNoteDescstringVariesEnumerated list of descriptive notes that are associated with the AddressNoteCodes field.
EmailCertaintystring3VariesScore between 0 and 100 that indicates the validity of a given email address
EmailQualitystring10Reject, Review or AcceptA field indicating whether the given email address should be rejected, reviewed or accepted
EmailCorrectedstring60VariesThe email used for testing including any corrections that were made.
EmailNoteCodesstringVariesEnumerated list of codes indicating additional information about the given email address
EmailNoteDescstringVariesList of descriptions associated with the EmailNoteCodes field.
IPAddressCertaintystring3VariesScore between 0 and 100 that indicates the validity of a given IP address.
IPAddressQualitystring10Reject, Review or AcceptA field indicating whether the given IP address should be rejected, reviewed or accepted
IPCountrystring60VariesCountry ISO 2 code associated with the given IP address
IPLocalitystring60VariesThe locality associated with the given IP address
IPAdminAreastringVariesAdministrative area associated with the given IP address
IPNoteCodesstringVariesEnumerated list of codes indicating additional information about the given IP address
IPNoteDescstringVariesDescriptions associated with the IPNoteCodes that indicate additional information about a given IP address
Phone1Certaintystring3VariesScore between 0 and 100 that indicates the validity of the phone number in the Phone1 field.
Phone1Qualitystring10Reject, Review or AcceptA field indicating whether the Phone1 input should be rejected, reviewed or accepted.
Phone1Localitystring60VariesLocality associated with the given IP address
Phone1AdminAreastring60VariesThe administrative area associated with the given phone number.
Phone1Countrystring3VariesThe Country ISO 2 code associated with the given phone number in the Phone1 field.
Phone1NoteCodesstringVariesNote codes containing additional
Phone1NoteDescstringVariesDescriptions that correlate with the codes given in the Note Codes field
Phone2Certaintystring3VariesNot currently used 
Phone2Qualitystring10Reject, Review or AcceptNot currently used 
Phone2Localitystring60VariesNot currently used 
Phone2AdminAreastring60VariesNot currently used 
Phone2Countrystring3VariesNot currently used 
Phone2NoteCodesstringVariesNot currently used 
Phone2NoteDescstringVariesNot currently used 
PhoneContactPhoneContactVariesThe contact information associated with the phone number
InformationComponentsInformationComponent[]VariesAn array of key value pairs that contain additional fields and information not defined in the original output schema of the API.
ErrorErrorVariesSee “Errors“.
NameTypeValuesDescription
NameStringVariesThe contact’s full name.
AddressStringVariesThe contact’s postal address.
CityStringVariesThe city of the contact’s postal address.
StateStringVariesThe state of the contact’s postal address.
ZipStringVariesThe zip code of the contact’s postal address.
TypeStringRESIDENTIAL BUSINESS
UNKNOWN

The contacts phone type.
NameTypeValuesDescription
NamesrtringVariesThe component name of the Name-Value pair
ValuesrtringVariesThe component value of the Name-Value pair.

References

  1. Customizing DOTS Lead Validation to Your Needs
  2. How Lead Validation Works
  3. Lead Validation: The Core Components