The Data Group

Phone Lookup Tutorial

Overview

Phone Lookup is a real-time solution for retrieving information about the owner of a given Phone Number.

Phone Lookup URI

The Phone Lookup URI accepts a Phone Number and returns the owner’s name and address.

Required Information

The Phone Lookup URI, like all of the solution URIs, requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key.

The Phone Lookup URI must be used with a POST request, where the request payload contains the Phone Number to look up.

Example

Request URL
The URL for the Phone Lookup URI is: https://api.thedatagroup.com/{version}/sync/lookup/phone, where {version} is the API Version you wish to use.
 
Request Headers
Header AttributeHeader Value
x-api-key{your api key}
Content-Typeapplication/json
Request Payload

The request payload for the Phone Lookup URI must contain the phone attribute.

{ "phone": "5555555555" }
cURL Example

To query the Phone Lookup URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.

curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{ "phone": "2078382232" }' "https://api.thedatagroup.com/v3/sync/lookup/phone"
Response Payload

The response payload for the Phone Lookup URI will contain the name and address information of the person associated with the request Phone Number.

{ "first_name": "Richard", "last_name": "Young", "address": { "street_number": "4689", "street_name": "Lakewood", "street_type": "