Reassigned Authority (GET)
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority"
headers = {"loginId": "<loginid>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority")
.header("loginId", "<loginid>")
.asString();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"
}
Reassigned Scrub
Reassigned Authority (GET)
Check if a phone number has been reassigned since a given consent date
GET
/
v1.5
/
Data
/
TCPAAuthority
Reassigned Authority (GET)
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority"
headers = {"loginId": "<loginid>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority")
.header("loginId", "<loginid>")
.asString();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
string
required
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 YYYYMMDDboolean
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 validstring
Type of phone line:
Wireless, VoIP, Landline, Paging, or Unknownstring
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");
}