Dotsleadvalidationinternational NPM

Service Objects - Lead Validation International

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.

Getting Started
ValidateLeadInternational - Inputs - Response
Features
Developer Guide
License Key

Getting Started

Create a new Node.js project

Install the LVI module

npm install dotsleadvalidationinternational

Load in the module to your project

var LeadValidationInternational = require(dotsleadvalidationinternational);

Call the validateLeadInternational() method

LeadValidationInternational.validateLeadInternational(
    FullName,
    Salutation,
    FirstName,
    LastName,
    BusinessName,
    BusinessDomain,
    BusinessEIN,
    Address1,
    Address2,
    Address3,
    Address4,
    Address5,
    Locality,
    AdminArea,
    PostalCode,
    Country,
    Phone1,
    Phone2,
    Email,
    IPAddress,
    Gender,
    DateOfBirth,
    UTCCaptureTime,
    OutputLanguage,
    TestType,
    LicenseKey,
    Environment,
    function(err, response){...}
);

ValidateLeadInternational

Inputs

Parameter	Type	Length	Value
FullName	String	60	The contact's full name. e.g. Jane Doe
Salutation	String	10	Salutation of the contact. Dr, Esq, Mr, Mrs etc
FirstName	String	60	First name of the contact. e.g. Jane
LastName	String	60	Last name of the contact. e.g. Doe
BusinessName	String	60	The contacts company. e.g. Service Objects
BusinessDomain	String	60	Website domain associated with the business. e.g. serviceobjects.com
BusinessEIN	String	60	Represents the Company Tax Number. Used for Tax exempt checks for US leads.
Address1	String	60	The address 1 of the contact or business address.
Address2	String	60	The address 2 of the contact or business address.
Address3	String	60	The address 3 of the contact or business address.
Address4	String	60	The address 4 of the contact or business address.
Address5	String	60	The address 5 of the contact or business address.
Locality	String	60	The city of the contact's postal address.
AdminArea	String	60	The state of the contact's postal address.
PostalCode	String	20	The zip code of the contact's postal address.
Country	String	60	The country of the contact's postal address. e.g. United States, US or USA
Phone1	String	20	The contact's primary phone number.
Phone2	String	20	The contact's secondary phone number.
Email	String	60	The contact's email address.
IPAddress	String	45	The contact's IP address in IPv4. (IPv6 coming in a future release)
Gender	String	10	Male, Female or Neutral
DateOfBirth	String	10	The contact's date of birth.
UTCCaptureTime	String	10	The time the lead was submitted.
OutputLanguage	String	20	Language field indicating what language some of the output information will be.
TestType	String	20	The name of the type of validation you want to perform on this contact.
LicenseKey	String	20	Your license key to use the service.
Environment	String	10	"trial" OR "production"

Response

{
	"OverallCertainty":"String content",
	"OverallQuality":"String content",
	"LeadType":"String content",
	"LeadCountry":"String content",
	"NoteCodes":"String content",
	"NoteDesc":"String content",
	"NameCertainty":"String content",
	"NameQuality":"String content",
	"FirstNameLatin":"String content",
	"LastNameLatin":"String content",
	"FirstName":"String content",
	"LastName":"String content",
	"NameNoteCodes":"String content",
	"NameNoteDesc":"String content",
	"AddressCertainty":"String content",
	"AddressQuality":"String content",
	"AddressResolutionLevel":"String content",
	"AddressLine1":"String content",
	"AddressLine2":"String content",
	"AddressLine3":"String content",
	"AddressLine4":"String content",
	"AddressLine5":"String content",
	"AddressLocality":"String content",
	"AddressAdminArea":"String content",
	"AddressPostalCode":"String content",
	"AddressCountry":"String content",
	"AddressNoteCodes":"String content",
	"AddressNoteDesc":"String content",
	"EmailCertainty":"String content",
	"EmailQuality":"String content",
	"EmailCorrected":"String content",
	"EmailNoteCodes":"String content",
	"EmailNoteDesc":"String content",
	"IPCertainty":"String content",
	"IPQuality":"String content",
	"IPLocality":"String content",
	"IPAdminArea":"String content",
	"IPCountry":"String content",
	"IPNoteCodes":"String content",
	"IPNoteDesc":"String content",
	"Phone1Certainty":"String content",
	"Phone1Quality":"String content",
	"Phone1Locality":"String content",
	"Phone1AdminArea":"String content",
	"Phone1Country":"String content",
	"Phone1NoteCodes":"String content",
	"Phone1NoteDesc":"String content",
	"Phone2Certainty":"String content",
	"Phone2Quality":"String content",
	"Phone2Locality":"String content",
	"Phone2AdminArea":"String content",
	"Phone2Country":"String content",
	"Phone2NoteCodes":"String content",
	"Phone2NoteDesc":"String content",
	"PhoneContact":{
		"Name":"String content",
		"Address":"String content",
		"City":"String content",
		"State":"String content",
		"Zip":"String content",
		"Type":"String content"
	},
	"BusinessCertainty":"String content",
	"BusinessQuality":"String content",
	"BusinessName":"String content",
	"BusinessDomain":"String content",
	"BusinessEmail":"String content",
	"BusinessNoteCodes":"String content",
	"BusinessNoteDesc":"String content",
	"InformationComponents":[{
		"Name":"String content",
		"Value":"String content"
	}],
	"Error":{
		"Type":"String content",
		"TypeCode":"String content",
		"Desc":"String content",
		"DescCode":"String content"
	},
	"DEBUG":"String content"
}

Features

For trial keys, set the Environment variable to "trial". Once you purchase a production license key, swap the Environment variable to "production" and change out your LicenseKey to your new license key.

The module automatically handles failover logic when using the production environment. This helps to ensure your web service requests are made sucessfully regardless of any network interuptions.