tcpa_authority Tool - Contact Center Compliance

The tcpa_authority tool provides phone number reassignment using carrier deactivation data.

Parameters

array

required

Array of objects containing phone numbers and consent dates.

Show phoneNumber object

string

required

10-digit North American phone number (e.g., "5039367187").

Date consent was given in YYYYMMDD, MM/DD/YYYY, or YYYY-MM-DD format.

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

Response

boolean

Whether the API call succeeded.

array

Array of results, one per phone number.

Show result object

string

The phone number checked.

boolean | null

true - Number has been reassigned (do not call)
false - Number has not been reassigned (safe to call)
null - Insufficient data to determine

boolean

Whether this is a valid, callable phone number.

boolean

true if valid and not reassigned.

string

Wireless, VoIP, Landline, Paging, or Unknown.

string

Original carrier the number was assigned to.

string

City based on original number assignment.

string

State/region code.

string

Two-letter ISO country code.

string

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

number

UTC offset in minutes.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Examples

Request
Response

{
  "phoneNumbers": [
    {
      "phoneNumber": "5039367187",
      "consentDate": "2023-06-15"
    }
  ]
}

{
  "success": true,
  "results": [
    {
      "phone": "5039367187",
      "isReassigned": false,
      "isValid": true,
      "isSafeToCall": true,
      "lineType": "Wireless",
      "carrier": "Verizon Wireless",
      "city": "Portland",
      "state": "OR",
      "country": "US",
      "timezone": "America/Los_Angeles",
      "utcOffset": -480
    }
  ]
}

Usage Notes

Requires Reassigned Authority access on your DNCScrub account

​Parameters

​Response

​Examples

​Usage Notes

Parameters

Response

Examples

Usage Notes