Page tree
Skip to end of metadata
Go to start of metadata

The Sample Code is Giving Strange Errors or is Crashing!

Most likely, the sample code cannot connect to Service Objects. Many environments will not allow you to connect out on port 80 or will clip out XML data from these requests/responses.

The easiest way to check for this is to open a browser on the machine running the sample code. In your browser, navigate to:

Then try to run one of the operations with your trial key. If you get a browser error or get no data back, then the sample code isn't able to connect, either. Contact your systems administrator to resolve why you are not able to connect to Service Objects.

How often do you update your data?

Address data is updated monthly. Phone and IP data is updated daily. Email data is not updated, it is checked dynamically (we test the email at the time of the request).

Can DOTS Lead Enhancement give me the information for Canadian Leads?

Yes – normally. Our dataset for Canada isn't as extensive as our dataset for the US, but DOTS Lead Enhancement returns information for Canadian phone numbers and addresses.

Where do you get your address information?

We gather our data from many various sources. The short answer is the US Postal Service.

What does the address error "Multiple addresses match." mean? How do I get a single result?

"Multiple addresses match." means that LE found the address, but couldn't resolve it from other addresses that were very similar, typically because of directional elements. For example, if you validate "123 Main street, Anytown, CA", but in Anytown, CA, there is only a "West Main street" and an "East Main street", then this will result in a "Multiple Addresses Match". You will need to specify either West Main or East Main as the street name to get a corrected, single address. There are other cases in which "multiple addresses match" will occur, but are rare and often have to do with a difference in zip+4, or suite numbers.

I got an "Insufficient address data" error from my address. What does that mean?

This error is a catchall for gross errors in the input address. It generally means that the address was too incomplete to piece together or too messy to parse out into identifiable parts.

DOTS Lead Enhancement doesn't return any contact data for my phone number!

This service was not designed to return contact information. It returns only basic carrier level information. If you are interested in a service that does return additional phone contact data, please see DOTS Lead Enhancement Plus. DOTS Lead Enhancement Plus is a premium service that adds some additional data points including the phone contact as well as appending potential alternative phone numbers to a lead. To find out more information, contact your sales rep or look at the following link:


Can DOTS Lead Enhancement give me the information for a disconnected number?

No, this is not currently available in this service. If you are interested in using this data, please contact us at, and we will let you know when that has been implemented.This service only does basic phone checks and will not do any disconnected testing. The only service that currently does a disconnected number check is our DOTS Lead Validation service. You can find out more about that service by contacting your sales rep or looking at the following link:

I don't care so much about who is at the phone number. I care more about whether the phone number is real or not. What should I do?

You have several options. You can either check for the presence of exchange data (valid phone numbers always return exchange information) or integrate Service Objects' Phone Exchange web service, which was built expressly for this purpose. Find out more about Phone Exchange here:

Can I get more detail on the possible outcomes for NameNotes?

These fields are designed to notify the user when something strange was found while validating the name component. A celebrity note will be returned if the name matches a known celebrity or character. A vulgar note will be returned if the name matches a vulgar word. This needs to be a match of a vulgar word to one of the names not a part of a name. For example, "Shitake" or "Bass" will not return as vulgar. An example of a nonsensical name would be I. P. Freely. A name that is made of random characters contains combinations of letters or special characters that are not likely to be in a real name. A dictionary word identifies names like "Happy Day" or "Gang Love" that are not likely to be a real name.

Ok, how about EmailNotes?

These fields identify interesting or noteworthy pieces of information about the email address. A catchall server is a mail server that always accepts mail to any box in that domain (*@domain). This helps hide valid email addresses from spammers but makes it difficult to validate whether an email is good or not. A bogus email is an indicator of obviously bogus email addresses such as, and A vulgar email is simply one that contains vulgar words. An email that is established with spammers is one that is known within large lists of a bulk-marketing list. An email is considered an alias if it matches the alias rules for different sites. For example, any email with "+" in it at is an alias. Also used to identify disposable emails such as where someone can get a temporary email address. An email made of random characters is one that has an excessive amount of letters that do not seem to mean anything.

What are the types of proxies returned in IPAddressProxyType?

It's not unusual to come across proxies while investigating IP addresses. Proxies are never great because they give the user the ability to hide their location, intended or not. This service returns three types of proxies: PRIVATE, PUBLIC and ANONYMOUS. Private proxies are very common. AOL and MSN internet service users will all have IP's using private proxies. Since these are common and legitimate, they will most likely not be fraudulent. However, having an AOL IP address does allow the user to hide their true location and there is always the potential for fraud. Public proxies are most definitely bad. IP's that have been reported as either hacked computers or are known to have made fraudulent requests are labeled as PUBLIC. IP addresses with the tag ANONYMOUS represent IP's that are intentionally misleading their location. A user can log into a service (providing this proxy) and make requests from there (the service can be anywhere and masks the user's original location). While these types of proxies are not necessarily fraudulent the intent to hide location is inherently very high risk.

I need more information on the output field IsEmailAddressValid what does it mean?

The results of this field are based on several other included results (primarily errors and email notes). A "FALSE" result indicates a high likelihood of a bad email. Any combination of bad DNS, SMTP, mailbox or vulgar, alias, or bogus email addresses will return a "FALSE". This should be considered a strong guess or likely indicator of a bad email and not a guaranteed check. It's definitely possible for someone to have a vulgar word in their normal email address, we just do not think it should be considered a good one. Since all of the elements that make up this check are included in the output, you as the user, are more than welcome to use your own criteria for determining email validity.

Important Note!
A full email mail box check is not performed during the normal run of a DOTS LeadEnhancement transaction because this check can be very time consuming. However, if we happen to know that the email is good or bad, we will include those results.

I'm Not a Programmer. How Do I Use DOTS Lead Enhancement?

Service Objects runs batches for you! A free batch trial is available at

  • No labels