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.

GeoPhone Plus 2 doesn't find any data for my phone number!

If your phone number is unlisted, by law, it cannot find any contact information for your number. Additionally, if your number is for a cellular phone, it cannot find that contact information either. 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.

GeoPhone Plus 2 is giving someone else's information for my phone number!

GeoPhone Plus's data is updated constantly. In the case that you just changed your number, it is possible it has not been updated since you made the change. Occasionally phone companies take their time in publishing updates.

If the information is not accurate, and the given phone number has not recently changed ownership, please let us know at

Can GeoPhone Plus 2 give me the information for a Canadian phone number?

Yes – normally. Our dataset for Canada isn't as extensive as our dataset for the US, but GeoPhone Plus returns information for Canadian phone numbers.

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 are registered to that phone number, which happens with many small businesses. Oftentimes, when you call the 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.

What does the QualityScore output in the contact object mean?

The QualityScore in the contact provides a rating on data source quality. In the event that Service Objects obtained useful but less reliable phone contact information this output would be used to identify these new data sources. For now all Landline numbers, a HIGH QualityScore will be returned, for wireless numbers come back as HIGH,MED or LOW depending on CallerID match.

What are tokens?

See Appendix A for more details on tokens

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' PhoneExchange web service, which was built expressly for this purpose. Find out more about PhoneExchange here:

I'm Not a Programmer. How Do I Use DOTS GeoPhone Plus 2?

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


  1. Reverse Phone Lookup APIs – Differences Between GeoPhone & GeoPhone Plus

  2. Service Objects Improves Phone Data by 200%

More Information

Appendix A – Tokens: An Advanced Feature

The standard usage and pricing plan for use of DOTS GeoPhone Plus 2 is based on transactions as the aggregated and charged for unit. Transactions in this context are defined as: any DOTS GeoPhone Plus 2 procedure call made to Service Objects web service, regardless of returned information or use of returned information. There is an advanced feature of DOTS GeoPhone Plus for more sophisticated users called Tokens. A Token is a unit of cost where different results are weighted differently resulting in a variable cost per transaction type. Transactions pricing is therefore variable and the plan is based on purchasing an amount of Tokens per month rather than Transactions. If a user desires closer accounting and measurement of specific Procedures used by their application and a payment plan that reflects this through variable pricing then the use of Tokens may provide added value. The Token cost structure is listed in the following table.

Match Type:

GetPhoneInfo Operation

Successful Landline Match:

85 tokens

Successful Wireless Match:

135 tokens

Successful Toll-Free Number Match:

95 tokens

Invalid Phone Number:

5 tokens

Exchange Level Match:

35 tokens

The base check is always applied and therefore every transaction will cost at least 5 tokens (for an Invalid Phone Number match). The rest are applied only if a match is found. A carrier match is when basic telephone company information is found. Only one of the contact matches will be used per transaction (whichever best applies). So a landline number with a full contact will be 85 tokens and a wireless number with a full contact will be 135 tokens.

If you decide that use of the Token based structure and pricing plan may be an advantage for you please contact Service Objects Sales Team for assistance: or 1-805-963-1700.

  • No labels