Introduction

DOTS GeoPhone Plus 2 (referred to as “GeoPhone Plus 2” or “GPPL 2”) is a publicly available XML web service that provides reverse phone lookup information about a US (or sometimes Canadian) phone number. The service provides name, address, city, state and lat/long, along with carrier exchange information.

This service provides Landline, Wireless and Toll free contact data are all available with one call to the service. GeoPhone Plus 2 can provide instant reverse-phone lookup verification to websites or data enhancement to contact lists. However, the output from GP must be considered carefully before the existence or non-existence of a given phone number is decided.

If you are an existing client and are using the previous version of this service then please click on the following link.

DOTS GeoPhone Plus

Resources

Free API Trial Key

Test the service for free with 500 complimentary transactions.

Sample Code

View sample code in PHP, JAVA, C# and other supported protocols and languages.

Upload Your List

Test our APIs and discover the possibilities by uploading a test list.

Sample Data

Use our sample input data to get started testing our services right away.

Quick Lookups

Seeing is believing. Use our quick lookups to see how each API transforms your data.

Developer Guide Map

  • Operations

    This section lists the DOTS GeoPhone Plus 2 operations and goes into the details behind the inputs and outputs.

    Operations:

  • Codes

    This section shows additional supporting data tables for the Codes values returned by DOTS GeoPhone Plus 2 operations.

  • Errors

    This section reflects details on the error outputs that can happen with the service.

  • Code Snippets and Sample Code

    Here you’ll find code snippets for various programming languages and frameworks along with links to our sample code page on the web site.

  • Try The API

    This is where you’ll go to take the API for a spin.  There you can test our recommended operation GetPhoneInfo.

  • Service Reference

    In this section you’ll find all the different endpoints supported by this service, input and output schema information as well as an opportunity to try the other endpoints as well.

  • Frequently Asked Questions

    This is a list of some of the questions we hear more often that you can reference and get answers on right away.

Integration Basics

Integrating GPPL2 into your application should be easy and straightforward. If you are using a common platform, Service Objects may already have sample code built that you can use:

https://www.serviceobjects.com/developers/sample-code/

However, if you are using a common platform that does not already have sample code, you can ask Service Objects to build you an example. Email support@serviceobjects.com for more details.

Web Service Structure:

Web services are methods that integrate with other applications via the web, and encapsulate tricky business logic. Web services are too large of a topic to cover in this document, but Service Objects has developed its web services to be as easy to integrate and as accessible as possible. 

GeoPhone Plus is a public XML web service that supports SOAP, POST and GET operations.

The host path, or physical location of the web service is here:
https://trial.serviceobjects.com/gppl2/api.svc

The location of the WSDL, or Web Service Definition Language document, is here (This is also accessible via the “Service Definition” link.):
https://trial.serviceobjects.com/gppl2/api.svc?WSDL

In addition, there is a single WSDL page available for parsers that have difficulty parsing nested documents.
https://trial.serviceobjects.com/gppl2/api.svc?singleWSDL

Important Notes!

  1. SOAP is done via POST, only with special XML markup in the post-body.

This WSDL is the definition of the web service, meaning its inputs, outputs, operations, and the like. Most likely, you will have another tool read this WSDL and make the operations available to you in your application. Whenever your utilities or IDE asks for a WSDL path to GeoPhone Plus, you can provide this one. Every web service has operations that it offers to subscribers – methods that do different work and return different output. Currently GeoPhone Plus 2 has one operation.