DOTS Lead Validation International (LVI) evaluates international lead data and scores the data quality into pass/fail/review categories. By evaluating the information quality of a contact, online marketers can more effectively weed-out fraudulent contacts.Online fraudsters are more likely to provide inaccurate contact information because the address and phone number can be easily traced. Unlike other validation services that perform simple data checks on single variables, Service Objects Lead Validation solution is able to cross-validate that a contact’s name, address, phone numbers, e-mail and IP address are all matched each other and are related to the consumer.

URL Endpoints

Lead Validation International provides all of the functionality of the Lead Validation service but is able to process and handle international leads. It takes all of the standard information that a typical web form would provide: name, address, phone, email, and IP address. 
In addition to the full functionality of the original service.

ValidateLeadInternational 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-validation-international.

*All input values are required

ValidateLeadInternational Outputs 

NameTypeLengthValueDescription
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
Accept
A field indicating whether the lead should be rejected,
reviewed or accepted
LeadTypeString10Residential,
Business or
Unknown
Indicates the classification that the service made for
the lead.
LeadCountryString2VariesThe 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.
FirstNameLatinString60VariesThe first name of the lead without diacritic characters.
LastNameLatinString60VariesThe 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.
AddressQualityString10VariesA field indicating whether the given address should
be rejected, reviewed or accepted
AddressLine1String60VariesThe validated Address line 1
AddressLine2String60VariesThe validated Address line 2
AddressLine3String60VariesThe validated Address line 3
AddressLine4String60VariesThe validated Address line 4
AddressLine5String60VariesThe 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.
AddressCountryString2Varies2 Character ISO code for the country
AddressResolutionLevelString100VariesThe resolution of the address
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
Accept
A 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.
IPCertaintyString3VariesScore between 0 and 100 that indicates the validity of
a given IP address.
IPQualityString10Reject, Review or
Accept
A field indicating whether the given IP address should
be rejected, reviewed or accepted
IPCountryString2VariesCountry 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 Accept
A 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.
Phone1CountryString2VariesThe Country ISO 2 code associated with the given
phone number in the Phone1 field.
Phone1NoteCodesStringVariesEnumerated list of codes indicating additional
information about the given phone 1
Phone1NoteDescStringVariesDescriptions that correlate with the codes given in the
Note Codes field
Phone2CertaintyString3VariesScore between 0 and 100 that indicates the validity of
the number given in the Phone2 field.
Phone2QualityString10Reject, Review
or Accept
A field indicating whether the Phone2 input should be
rejected, reviewed or accepted.
Phone2LocalityString60VariesLocality associated with the given Phone Number
Phone2AdminAreaString60VariesThe administrative area associated with the given
phone number.
Phone2CountryString2VariesThe Country ISO 2 code associated with the given
phone number in the Phone2 field.
Phone2NoteCodesStringVariesEnumerated list of codes indicating additional
information about the given phone 2
Phone2NoteDescStringVariesDescriptions that correlate with the codes given in the
Note Codes field
PhoneContactPhoneContactVariesThe contact information associated with the phone
number
BusinessCertaintyString3VariesScore between 0 and 100 that indicates the validity of
the BusinessName.
BusinessQualityString10Reject, Review or
Accept
A field indicating whether the Business Name input
should be rejected, reviewed or accepted.
BusinessNameStringVariesComing soon, returns no value currently.
BusinessDomainStringVariesThe website domain associated with the business
BusinessEmailStringVariesThe business email
BusinessNoteCodesStringVariesEnumerated list of codes indicating additional
information about the given Business Name
BusinessNoteDescStringVariesDescriptions that correlate with the codes given in the
note codes field
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“.

PhoneContact Type

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 UNKNOWNThe contacts phone type.

InformationComponent

NameTypeValuesDescription
NameStringVariesThe component name of the Name-Value
pair
ValueStringVariesThe 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
  4. Lead Validation, Part 2: Advanced Features and Capabilities
  5. Lead Validation, Part 3: International Lead Validation