Disconnect Verify Tutorial

Overview

Disconnect Verify is a real-time solution for verifying the disconnection status of a given phone number, and provided additional details regarding the phone number.

Disconnect Verify URI

The Disconnect Verify URI accepts a phone number and returns the connected status for the phone number, as well as other general information regarding the phone number.

Required Information

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

The Disconnect Verify 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 Disconnect Verify URI must be used with a POST request, where the request payload contains the phone number to verify. Example Request URL The URL for the Disconnect Verify URI is: https://api.thedatagroup.com/{version}/sync/verify/disconnect, where {version} is the API Version you wish to use.

Request Headers

Request Payload

The request payload for the Disconnect Verify URI must contain the email attribute.

{
 "phone": "5558675309"
}

cURL Example

To query the Disconnect Verify 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": "5558675309"
}' "https://api.thedatagroup.com/v3/sync/verify/disconnect"

Response Payload

The response payload for the Disconnect Verify URI will contain the person’s name and address. It also contains a boolean indicating whether or not the phone number is flagged as connected, as well as information regarding the phone type, the provider, the record type, confidence score, ect.

{
 "connected": true,
 "address": {
 "street_number": "4689",
 "street_name": "Lakewood",
 "street_type": "DR",
 "city": "Fleming Island",
 "zipcode": "32003",
 "state": "FL"
 },
 "phone": {
 "phone_type": "W",
 "phone": "5558675309",
 "provider": "Wireless Co",
 "operating_company_number": "W8V7",
 "confidence_score": 2,
 "initial_date_received": "19950315",
 "last_date_received": "20160127",
 "directory_assistance": "REMOVED",
 "record_type": "RESIDENTIAL",
 "direct_inward_dial_number": true
 },
 "last_name": "Young",
 "middle_name": "H",
 "first_name": "Richard"
}