Skip to main content
GET
https://dataapi.dncscrub.com
/
v1.4
/
Data
/
TCPAAuthority
Reassigned Authority (GET)
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.4/Data/TCPAAuthority \
  --header 'loginId: <loginid>'
{
  "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

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)

​
Query Parameters

​
phoneNumber
string
required
10-digit North American phone number (without leading 1 or +)
​
date
string
required
Consent date to check reassignment against. Supported formats: MM/DD/YYYY, YYYY-MM-DD, MM/DD/YY, or YYYYMMDD
​
useSandbox
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.4/Data/TCPAAuthority?phoneNumber=7075276405&date=20210209' \
  --header 'loginId: YOUR_API_KEY'

{
  "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

​
PhoneNumber
string
The phone number that was checked
​
IsReassigned
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.
​
IsValid
boolean
true if the phone number is valid and callable, false if not valid
​
LineType
string
Type of phone line: Wireless, VoIP, Landline, Paging, or Unknown
​
Carrier
string
Original carrier the phone number was assigned to
​
Locale
string
City based on original phone number assignment
​
Region
string
State/region based on original phone number assignment
​
Country
string
Two-digit ISO country code
​
TZ
string
Timezone in ISO IANA format (e.g., America/Los_Angeles)
​
UTCOffset
string
UTC offset in minutes. Use this to calculate the local time at the phone number.

​
Error Responses

StatusDescription
400 Bad RequestInvalid phone number format, invalid date format, or missing required parameters
401 UnauthorizedInvalid or missing API key
403 ForbiddenAccount 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");
}