Introduction
DOTS Address Detective International (“ADI”) is a utility service that provides tools to provide greater insight to existing data points, go outside of the box on complex location based problems and help clean up extremely messy data points.
The operation, FindBestCountry, is designed to analyze a given set of data points and correct or append the Country. Users with incorrect or missing country data can use the operation to fill in the blanks. It can also be used to enhance other services such as DOTS Address Validation – International or DOTS Lead Validation – International that require a country to properly process.
ADI’s FindBestCountry can help clean up messy CRMs, localize sales and marketing more effectively by providing the proper geographic location, or help companies identify a customer’s location to remain compliant when dealing with data protection laws like GDPR.
Resources
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 Address Detective International operations and goes into the details behind the inputs and outputs.
Operations: - Note Codes and Warning Codes
This section shows additional supporting data tables that are associated to the DOTS Address Detective International 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 FindBestCountry. - 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 ADI 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.
ADI is a public XML web service that supports SOAP, POST and GET operations, using RESTful paradigms or simple HTTP transport calls.
A test page for the recommended operation can be found here:
ADI – Try The API
See the service references and try the other operations here:
ADI – Service Reference
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/ADI/soap.svc?wsdl
Important Notes!
- This XML 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 ADI, you can provide this one.
- SOAP is done via POST, only with special XML markup in the post-body.