Skip to main content
POST
Reassigned Authority (POST)
Check multiple phone numbers for reassignment since given consent dates using the TCPA Authority API. Use POST for batch processing up to 1,000 numbers per request.
For single number lookups, you can use the GET method instead.

Request

Headers

string
required
Your API Key (LoginId from your DNCScrub account)
string
required
Must be application/json

Request Body

array
required
Array of phone number and date pairs to check
boolean
default:"false"
(Optional) Set to true to use sandbox mode for testing (returns random results)

Example Request

Response Fields

Each object in the response array contains:
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

Error Responses

Batch Processing Example