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 Plus 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 Plus 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 LEP 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 Plus doesn't return any contact data for my phone number!

If your phone number is unlisted the contact data for your number may be unavailable. Additionally, if your number is for a cellular phone, contact data may be less consistently returned. If it does not return any information for the exchange, then you may have mistyped your phone number. A valid phone number will always return exchange information, whether it is wireless or landline, connected or disconnected.


Can DOTS Lead Enhancement Plus 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.

I'm seeing multiple contacts at a single phone number. Who is really going to pick up the phone?

Honestly, any one of them! Typically, this means that multiple people registered at that phone number, which happens with many small businesses. Oftentimes, when you call that number, you will get an operator or switch where you can ask for the person you're looking for. If the phone number resolves to a residential address, all of the contacts may be roommates. If you need to verify that a particular person is at that phone number, simply search for that person in the list of contacts. They are not in any particular order when they are returned.

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 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 users 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 Lead Enhancement Plus 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 see another service called DOTS Lead Enhancement. What is the difference between this service and that one?*

DOTS Lead Enhancement Plus is a premium service that has access to data sources not available to the DOTS Lead Enhancement service. These include phone contact data (contact name and address) and the appending of alternative phone numbers for leads. DOTS Lead Enhancement otherwise provides similar results and can be a good option for any users on a strict budget.

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

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

Do you also provide a RESTful interface?

Yes we do! For more information on how to use our RESTful interface go here DOTS Lead Enhancement Plus - REST.

  • No labels