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

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

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

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

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

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

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

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");
}