{"id":4937,"date":"2022-11-13T13:07:38","date_gmt":"2022-11-13T13:07:38","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?page_id=4937"},"modified":"2026-03-02T10:13:18","modified_gmt":"2026-03-02T18:13:18","slug":"lv-validatelead_v3-recommended-operation","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/","title":{"rendered":"LV &#8211; ValidateLead_V3 &#8211; Recommended Operation"},"content":{"rendered":"<div style=\"height:27px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<nav aria-label=\"Lead Validation Navigation\">\n<ul>\n<li><a href=\"#LV-ValidateLead_V3-RecommendedOperation-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Inputs\">ValidateLead_V3 Inputs<\/a><\/li>\n<li><a href=\"#LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Outputs\">ValidateLead_V3 Outputs<\/a><\/li>\n<li><a href=\"#LV-ValidateLead_V3-RecommendedOperation-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>\n<div style=\"height:29px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<article aria-label=\"Lead Validation service description\">\n  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.<br \/>\n<\/article>\n<div style=\"height:29px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<article aria-label=\"Document definition\">\n  This document defines the input, output, and behavior of the web services in LV.<br \/>\n<\/article>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<div class=\"wp-block-group is-style-card-note\">\n<article aria-label=\"Important Note heading\">\n    <strong>Important Note!<\/strong><br \/>\n  <\/article>\n<article aria-label=\"Important Note description\">\n    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&#8217;s validity. LV provides a baseline guide of a lead&#8217;s quality that must be taken with serious consideration.<br \/>\n  <\/article>\n<\/div>\n<section aria-labelledby=\"LV-ValidateLead_V3-RecommendedOperation-URLEndpoints\">\n<h2 id=\"LV-ValidateLead_V3-RecommendedOperation-URLEndpoints\">URL Endpoints<\/h2>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON:<\/strong>\n<ul>\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/trial.serviceobjects.com\/lv\/api.svc\/JSON\/ValidateLead_V3?FullName={FULLNAME}&amp;Salutation={SALUTATION&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;BusinessName={BUSINESSNAME}&amp;BusinessDomain={BUSINESSDOMAIN}&amp;BusinessEIN={BUSINESSEIN}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Country={COUNTRY}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Gender={GENDER}&amp;DateOfBirth={DATEOFBIRTH}&amp;UTCCaptureTime={UTCCAPTURETIME}&amp;OutputLanguage={OUTPUTLANGUAGE}&amp;TestType={TESTTYPE}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\">https:\/\/trial.serviceobjects.com\/lv\/api.svc\/JSON\/ValidateLead_V3?FullName={FULLNAME}&amp;Salutation={SALUTATION&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;BusinessName={BUSINESSNAME}&amp;BusinessDomain={BUSINESSDOMAIN}&amp;BusinessEIN={BUSINESSEIN}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Country={COUNTRY}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Gender={GENDER}&amp;DateOfBirth={DATEOFBIRTH}&amp;UTCCaptureTime={UTCCAPTURETIME}&amp;OutputLanguage={OUTPUTLANGUAGE}&amp;TestType={TESTTYPE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>XML:<\/strong>\n<ul>\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/trial.serviceobjects.com\/lv\/api.svc\/XML\/ValidateLead_V3?FullName={FULLNAME}&amp;Salutation={SALUTATION&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;BusinessName={BUSINESSNAME}&amp;BusinessDomain={BUSINESSDOMAIN}&amp;BusinessEIN={BUSINESSEIN}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Country={COUNTRY}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Gender={GENDER}&amp;DateOfBirth={DATEOFBIRTH}&amp;UTCCaptureTime={UTCCAPTURETIME}&amp;OutputLanguage={OUTPUTLANGUAGE}&amp;TestType={TESTTYPE}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\">https:\/\/trial.serviceobjects.com\/lv\/api.svc\/XML\/ValidateLead_V3?FullName={FULLNAME}&amp;Salutation={SALUTATION&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;BusinessName={BUSINESSNAME}&amp;BusinessDomain={BUSINESSDOMAIN}&amp;BusinessEIN={BUSINESSEIN}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Country={COUNTRY}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Gender={GENDER}&amp;DateOfBirth={DATEOFBIRTH}&amp;UTCCaptureTime={UTCCAPTURETIME}&amp;OutputLanguage={OUTPUTLANGUAGE}&amp;TestType={TESTTYPE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<div style=\"display:flex; gap:16px; flex-wrap:wrap; margin:24px 0;\">\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Run This Request in Postman<\/h3>\n<p style=\"margin: 0; line-height: 1.4;\">Test with this example lead:<br \/>\n<a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/www.postman.com\/service-objects-api\/service-objects\/example\/41579131-c339b1e7-4b35-422e-a41c-1d11e2ab1324\" target=\"_blank\" rel=\"noopener\"><br \/>\nTim Cook, a business lead with name, business name, address, phone, and email<br \/>\n<\/a><\/p>\n<\/div>\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Check out the Integration Code in GitHub<br \/><\/h3>\n<p style=\"margin: 0; line-height: 1.4;\"><a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/github.com\/ServiceObjects\/lead-validation\" target=\"_blank\" rel=\"noopener\"><br \/>\nGitHub<br \/>\n<\/a><\/p>\n<\/div>\n<\/div>\n<section aria-labelledby=\"LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Inputs\">\n<h2 id=\"LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Inputs\">ValidateLead_V3 Inputs<\/h2>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>TestType and LicenseKey are the only required inputs, if they are missing or incorrect ValidateLead_V3 will throw an error. All other inputs are optional, but missing key data without a test type that accounts for it could cause tests to fail and potentially greatly impact the resulting score. (e.g. Omitting Name will cause all name tests to fail as well as name to email tests, name to phone tests, etc&#8230;)<\/li>\n<\/ul>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Length<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>FullName<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The contact&#8217;s full name. e.g. Jane Doe<\/td>\n<\/tr>\n<tr>\n<td>Salutation<\/td>\n<td>String<\/td>\n<td>10<\/td>\n<td>Salutation of the contact. Dr, Esq, Mr, Mrs etc<\/td>\n<\/tr>\n<tr>\n<td>FirstName<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>First name of the contact. e.g. Jane<\/td>\n<\/tr>\n<tr>\n<td>LastName<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>Last name of the contact. e.g. Doe<\/td>\n<\/tr>\n<tr>\n<td>BusinessName<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The contacts company. e.g. Service Objects<\/td>\n<\/tr>\n<tr>\n<td>BusinessDomain<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>Website domain associated with the business. e.g.&nbsp;<a rel=\"noreferrer noopener\" href=\"\/\" target=\"_blank\">serviceobjects.com<\/a><\/td>\n<\/tr>\n<tr>\n<td>BusinessEIN<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>Represents the Company Tax Number. Used for Tax exempt checks for US leads.<\/td>\n<\/tr>\n<tr>\n<td>Address1<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The address 1 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The address 2 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address3<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The address 3 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address4<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The address 4 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address5<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The address 5 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Locality<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The city of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>AdminArea<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The state of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>The zip code of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>Country<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The country of the contact&#8217;s postal address. e.g. United States, US or USA<\/td>\n<\/tr>\n<tr>\n<td>Phone1<\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>The contact&#8217;s primary phone number.<\/td>\n<\/tr>\n<tr>\n<td>Phone2<\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>The contact&#8217;s secondary phone number.<\/td>\n<\/tr>\n<tr>\n<td>Email<\/td>\n<td>String<\/td>\n<td>60<\/td>\n<td>The contact&#8217;s email address.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress<\/td>\n<td>String<\/td>\n<td>45<\/td>\n<td>The contact&#8217;s IP address in IPv4. (IPv6 coming in a future release)<\/td>\n<\/tr>\n<tr>\n<td>Gender<\/td>\n<td>String<\/td>\n<td>10<\/td>\n<td>Male, Female or Neutral<\/td>\n<\/tr>\n<tr>\n<td>DateOfBirth<\/td>\n<td>String<\/td>\n<td>10<\/td>\n<td>The contact&#8217;s date of birth<\/td>\n<\/tr>\n<tr>\n<td>UTCCaptureTime<\/td>\n<td>String<\/td>\n<td>10<\/td>\n<td>The time the lead was submitted<\/td>\n<\/tr>\n<tr>\n<td>OutputLanguage<\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>Language field indicating what language some of the output information will be.<\/td>\n<\/tr>\n<tr>\n<td><a rel=\"noreferrer noopener\" href=\"\/docs\/dots-lead-validation\/lv-test-types\/\" target=\"_blank\">TestType<\/a>&nbsp;<a rel=\"noreferrer noopener\" href=\"#LV-ValidateLead_V3-RecommendedOperation-CiteSummary_1\" target=\"_blank\"><sup>[1]<\/sup><\/a><\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>The name of the type of validation you want to perform on this contact.<\/td>\n<\/tr>\n<tr>\n<td>LicenseKey<\/td>\n<td>String<\/td>\n<td>20<\/td>\n<td>Your license key to use the service.&nbsp;<br \/>Sign up for a free trial key at&nbsp;<br \/><a rel=\"noreferrer noopener\" href=\"\/lead-validation\/\" target=\"_blank\">https:\/\/www.serviceobjects.com\/lead-validation\/<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<section aria-labelledby=\"LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Outputs\">\n<h2 id=\"LV-ValidateLead_V3-RecommendedOperation-ValidateLead_V3Outputs\">ValidateLead_V3 Outputs<\/h2>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>All of the response objects are contained within the ValidateLead_V3 object.<\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Length<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>OverallCertainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>A value that represents the overall certainty that the service provided on the lead. This value will range from 0 to 100.<\/td>\n<\/tr>\n<tr>\n<td>OverallQuality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the lead should be rejected, reviewed or accepted<\/td>\n<\/tr>\n<tr>\n<td>LeadType<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Residential, Business or Unknown<\/td>\n<td>Indicates the classification that the service made for the lead.<\/td>\n<\/tr>\n<tr>\n<td>LeadCountry<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>The country associated with the lead, given as an ISO 2.<\/td>\n<\/tr>\n<tr>\n<td>NoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of descriptive notes<\/td>\n<\/tr>\n<tr>\n<td>NoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Descriptions that correspond to the NoteCodes section<\/td>\n<\/tr>\n<tr>\n<td>NameCertainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>Score&nbsp;between 0 and 100 that indicates the probability that the given name is valid.<\/td>\n<\/tr>\n<tr>\n<td>NameQuality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the given name should be rejected, reviewed or accepted.<\/td>\n<\/tr>\n<tr>\n<td>FirstName<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The first name with diacritic characters.<\/td>\n<\/tr>\n<tr>\n<td>LastName<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The last name with diacritic characters.<\/td>\n<\/tr>\n<tr>\n<td>FirstNameClean<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The first name of the lead without diacritic characters.<\/td>\n<\/tr>\n<tr>\n<td>LastNameClean<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The last name of the lead without diacritic characters.<\/td>\n<\/tr>\n<tr>\n<td>NameNoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of codes indicating further information about the name field.<\/td>\n<\/tr>\n<tr>\n<td>NameNotesDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of descriptive notes that correspond to the NameNoteCodes field.<\/td>\n<\/tr>\n<tr>\n<td>AddressCertainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>Score&nbsp;between 0 and 100 that indicates the validity of the given address.<\/td>\n<\/tr>\n<tr>\n<td>AddressQuality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the given address should be rejected, reviewed or accepted<\/td>\n<\/tr>\n<tr>\n<td>Address1<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The validated Address line 1<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The validated Address line 2<\/td>\n<\/tr>\n<tr>\n<td>Address3<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The validated Address line 3<\/td>\n<\/tr>\n<tr>\n<td>Address4<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The validated Address line 4<\/td>\n<\/tr>\n<tr>\n<td>Address5<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The validated Address line 5<\/td>\n<\/tr>\n<tr>\n<td>AddressLocality<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The locality associated with the given input address. Usually corresponds to the city.<\/td>\n<\/tr>\n<tr>\n<td>AddressAdminArea<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The Admin Area tied with the input address. Usually corresponds to the State or Province.<\/td>\n<\/tr>\n<tr>\n<td>AddressPostalCode<\/td>\n<td>string<\/td>\n<td>20<\/td>\n<td>Varies<\/td>\n<td>The Postal Code tied to the given input address.<\/td>\n<\/tr>\n<tr>\n<td>AddressCountry<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>2 Character ISO code for the country<\/td>\n<\/tr>\n<tr>\n<td>AddressNoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of codes indicating additional information about the given address.<\/td>\n<\/tr>\n<tr>\n<td>AddressNoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of descriptive notes that are associated with the AddressNoteCodes field.<\/td>\n<\/tr>\n<tr>\n<td>EmailCertainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>Score&nbsp;between 0 and 100 that indicates the validity of a given email address<\/td>\n<\/tr>\n<tr>\n<td>EmailQuality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the given email address should be rejected, reviewed or accepted<\/td>\n<\/tr>\n<tr>\n<td>EmailCorrected<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The email used for testing including any corrections that were made.<\/td>\n<\/tr>\n<tr>\n<td>EmailNoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of codes indicating additional information about the given email address<\/td>\n<\/tr>\n<tr>\n<td>EmailNoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>List of descriptions associated with the EmailNoteCodes field.<\/td>\n<\/tr>\n<tr>\n<td>IPAddressCertainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>Score between 0 and 100 that indicates the validity of a given IP address.<\/td>\n<\/tr>\n<tr>\n<td>IPAddressQuality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the given IP address should be rejected, reviewed or accepted<\/td>\n<\/tr>\n<tr>\n<td>IPCountry<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>Country ISO 2 code associated with the given IP address<\/td>\n<\/tr>\n<tr>\n<td>IPLocality<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The locality associated with the given IP address<\/td>\n<\/tr>\n<tr>\n<td>IPAdminArea<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Administrative area associated with the given IP address<\/td>\n<\/tr>\n<tr>\n<td>IPNoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Enumerated list of codes indicating additional information about the given IP address<\/td>\n<\/tr>\n<tr>\n<td>IPNoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Descriptions associated with the IPNoteCodes that indicate additional information about a given IP address<\/td>\n<\/tr>\n<tr>\n<td>Phone1Certainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>Score between 0 and 100 that indicates the validity of the&nbsp;phone number in the Phone1 field.<\/td>\n<\/tr>\n<tr>\n<td>Phone1Quality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td>A field indicating whether the Phone1 input should be rejected, reviewed or accepted.<\/td>\n<\/tr>\n<tr>\n<td>Phone1Locality<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>Locality associated with the given IP address<\/td>\n<\/tr>\n<tr>\n<td>Phone1AdminArea<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td>The administrative area associated with the given phone number.<\/td>\n<\/tr>\n<tr>\n<td>Phone1Country<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td>The Country ISO 2 code associated with the given phone number in the Phone1 field.<\/td>\n<\/tr>\n<tr>\n<td>Phone1NoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Note codes containing additional<\/td>\n<\/tr>\n<tr>\n<td>Phone1NoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>Descriptions that correlate with the codes given in the Note Codes field<\/td>\n<\/tr>\n<tr>\n<td>Phone2Certainty<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2Quality<\/td>\n<td>string<\/td>\n<td>10<\/td>\n<td>Reject, Review or Accept<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2Locality<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2AdminArea<\/td>\n<td>string<\/td>\n<td>60<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2Country<\/td>\n<td>string<\/td>\n<td>3<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2NoteCodes<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Phone2NoteDesc<\/td>\n<td>string<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td><strong>Not currently used<\/strong>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>PhoneContact<\/td>\n<td>PhoneContact<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>The contact information associated with the phone number<\/td>\n<\/tr>\n<tr>\n<td>InformationComponents<\/td>\n<td>InformationComponent[]<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>An array of key value pairs that contain additional fields and information not defined in the original output schema of the API.<\/td>\n<\/tr>\n<tr>\n<td>Error<\/td>\n<td>Error<\/td>\n<td>&#8211;<\/td>\n<td>Varies<\/td>\n<td>See &#8220;<a rel=\"noreferrer noopener\" href=\"\/docs\/dots-lead-validation\/lv-errors\/\" target=\"_blank\">Errors<\/a>&#8220;.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong><em>PhoneContact Type<\/em><\/strong><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Name<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The contact&#8217;s full name.<\/td>\n<\/tr>\n<tr>\n<td>Address<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The city of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The state of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>Zip<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The zip code of the contact&#8217;s postal address.<\/td>\n<\/tr>\n<tr>\n<td>Type<\/td>\n<td>String<\/td>\n<td>RESIDENTIAL BUSINESS <br \/>UNKNOWN<\/p>\n<\/td>\n<td>The contacts phone type.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong><em>InformationComponent<\/em><\/strong><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Name<\/td>\n<td>srtring<\/td>\n<td>Varies<\/td>\n<td>The component name of the Name-Value pair<\/td>\n<\/tr>\n<tr>\n<td>Value<\/td>\n<td>srtring<\/td>\n<td>Varies<\/td>\n<td>The component value of the Name-Value pair.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<\/section>\n<section aria-labelledby=\"LV-ValidateLead_V3-RecommendedOperation-References\">\n<h2 id=\"LV-ValidateLead_V3-RecommendedOperation-References\">References<\/h2>\n<ol>\n<li><a href=\"#LV-ValidateLead_V3-RecommendedOperation-SingleCite_1_1\"><strong>^&nbsp;<\/strong><\/a><a rel=\"noreferrer noopener\" href=\"\/blog\/customizing-dots-lead-validation-needs\/\" target=\"_blank\"><strong>Customizing DOTS Lead Validation to Your Needs<\/strong><\/a><\/li>\n<li><strong><a rel=\"noreferrer noopener\" href=\"\/blog\/how-lead-validation-works\/\" target=\"_blank\">How Lead Validation Works<\/a><\/strong><\/li>\n<li><a rel=\"noreferrer noopener\" href=\"\/blog\/dots-lead-validation-deep-dive-part-1-the-core-components\/\" target=\"_blank\"><strong><\/strong><\/a><strong><a rel=\"noreferrer noopener\" href=\"\/blog\/dots-lead-validation-deep-dive-part-1-the-core-components\/\" target=\"_blank\">Lead Validation: The Core Components<\/a><\/strong><\/li>\n<\/ol>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References 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. [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":4931,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4937","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>LV - ValidateLead_V3 - Recommended Operation<\/title>\n<meta name=\"description\" content=\"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"LV - ValidateLead_V3 - Recommended Operation\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-02T18:13:18+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/\",\"name\":\"LV - ValidateLead_V3 - Recommended Operation\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-13T13:07:38+00:00\",\"dateModified\":\"2026-03-02T18:13:18+00:00\",\"description\":\"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Lead Validation\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"LV &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"LV &#8211; ValidateLead_V3 &#8211; Recommended Operation\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"LV - ValidateLead_V3 - Recommended Operation","description":"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/","og_locale":"en_US","og_type":"article","og_title":"LV - ValidateLead_V3 - Recommended Operation","og_description":"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2026-03-02T18:13:18+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/","name":"LV - ValidateLead_V3 - Recommended Operation","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-13T13:07:38+00:00","dateModified":"2026-03-02T18:13:18+00:00","description":"URL Endpoints ValidateLead_V3 Inputs ValidateLead_V3 Outputs References Our Lead Validation service cross-validates, corrects and scores over 130 key data","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/lv-validatelead_v3-recommended-operation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Lead Validation","item":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/"},{"@type":"ListItem","position":3,"name":"LV &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-lead-validation\/lv-operations\/"},{"@type":"ListItem","position":4,"name":"LV &#8211; ValidateLead_V3 &#8211; Recommended Operation"}]},{"@type":"WebSite","@id":"https:\/\/www.serviceobjects.com\/docs\/#website","url":"https:\/\/www.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/www.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/4937","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=4937"}],"version-history":[{"count":19,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/4937\/revisions"}],"predecessor-version":[{"id":12607,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/4937\/revisions\/12607"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/4931"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=4937"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}