Reassigned Authority (GET)

curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority \
  --header 'loginId: <loginid>'

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "IsValid": true,
  "LineType": "Landline",
  "Carrier": "AT&T California",
  "Locale": "Santa Rosa",
  "Region": "CA",
  "Country": "US",
  "TZ": "America/Los_Angeles",
  "UTCOffset": "-420"
}

GET

v1.5

Data

TCPAAuthority

Reassigned Authority (GET)

curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority \
  --header 'loginId: <loginid>'

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "IsValid": true,
  "LineType": "Landline",
  "Carrier": "AT&T California",
  "Locale": "Santa Rosa",
  "Region": "CA",
  "Country": "US",
  "TZ": "America/Los_Angeles",
  "UTCOffset": "-420"
}

Check if a phone number has been reassigned since a given consent date using the TCPA Authority API. This API uses authoritative data provided directly from carriers.

The date input should be the consent date the customer gave the calling party consent to be called. If IsReassigned returns true, do not call the number.

Request

Headers

Your API Key (LoginId from your DNCScrub account)

Query Parameters

string

required

10-digit North American phone number (without leading 1 or +)

string

required

Consent date to check reassignment against. Supported formats: MM/DD/YYYY, YYYY-MM-DD, MM/DD/YY, or YYYYMMDD

boolean

default:"false"

(Optional) Set to true to use sandbox mode for testing (returns random results)

Example Request

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority?phoneNumber=7075276405&date=20210209' \
  --header 'loginId: YOUR_API_KEY'

const response = await fetch(
  "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority?phoneNumber=7075276405&date=20210209",
  {
    method: "GET",
    headers: { loginId: "YOUR_API_KEY" },
  }
);
const data = await response.json();
console.log(data);

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

    var url = "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority?phoneNumber=7075276405&date=20210209";
    var response = await client.GetStringAsync(url);
    Console.WriteLine(response);
}

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "IsValid": true,
  "LineType": "Landline",
  "Carrier": "AT&T California",
  "Locale": "Santa Rosa",
  "Region": "CA",
  "Country": "US",
  "TZ": "America/Los_Angeles",
  "UTCOffset": "-420"
}

Response Fields

string

The phone number that was checked

boolean | null

Indicates if the phone was reassigned after the consent date: - true - Reassigned after the date. Do not call. - false - Not reassigned. Safe to call. - null - Insufficient information to determine reassignment status.

boolean

true if the phone number is valid and callable, false if not valid

string

Type of phone line: Wireless, VoIP, Landline, Paging, or Unknown

string

Original carrier the phone number was assigned to

string

City based on original phone number assignment

string

State/region based on original phone number assignment

string

Two-digit ISO country code

string

Timezone in ISO IANA format (e.g., America/Los_Angeles)

string

UTC offset in minutes. Use this to calculate the local time at the phone number.

Error Responses

Status	Description
400 Bad Request	Invalid phone number format, invalid date format, or missing required parameters
401 Unauthorized	Invalid or missing API key
403 Forbidden	Account not authorized for this API or insufficient credits

Processing the Response

const result = await response.json();

if (result.IsReassigned === true) {
  console.log("DO NOT CALL - Number has been reassigned");
} else if (result.IsReassigned === false) {
  console.log("Safe to call - Number has not been reassigned");
  console.log(`Line type: ${result.LineType}`);
  console.log(`Carrier: ${result.Carrier}`);
} else {
  console.log("Insufficient data to determine reassignment status");
}

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Reassigned Authority (GET)

Request

Headers

Query Parameters

Example Request

Response Fields

Error Responses

Processing the Response

​Request

​Headers

​Query Parameters

​Example Request

​Response Fields

​Error Responses

​Processing the Response

Request

Headers

Query Parameters

Example Request

Response Fields

Error Responses

Processing the Response