Previous Page

FREE API KEY

*Fields required.

Tutorials

Mobile Lookup Tutorial

Overview

Mobile Lookup is a real-time solution for retrieving information about the owner of a given Mobile Phone Number. If the number you are wanting to look up is not a Mobile Phone Number, try the Phone Lookup solution instead.

Mobile Lookup URI

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

Required Information

The Mobile Lookup URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.

The Mobile Lookup URI, like all of the solution URIs, also 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 Mobile Lookup URI must be used with a POST request, where the request payload contains the Mobile Phone Number to look up.

Example
Request URL

The URL for the Mobile Lookup URI is: https://api.thedatagroup.com/{version}/sync/lookup/mobile, where {version} is the API Version you wish to use.

Request Headers
Header Attribute Header Value
x-api-key {your api key}
AuthorizationToken {your authorization token}
Content-Type application/json
Request Payload

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

{ "phone": "301-991-0167" }
cURL Example

To query the Mobile 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": "301-991-0167" }' "https://api.thedatagroup.com/v3/sync/lookup/mobile"
Response Payload

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

{ "first_name": "Richard", "last_name": "Young", "address": { "street_number": "4689", "street_name": "Lakewood", "street_type": "DR", "city": "Fleming Island", "zipcode": "32003", "state": "FL" } }