is_reassigned_number Tool - Contact Center Compliance

The is_reassigned_number tool checks if a phone number has been reassigned to a new owner since consent was given, using the FCC Reassigned Numbers Database (RND).

When to Use

Use this tool before calling to ensure consent is still valid. If a number has been reassigned, the original consent no longer applies to the new owner.
Safe harbor is required

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 FCC safe harbor exemption may be available.

boolean

Simple yes/no based on isReassigned being false or null with safe harbor.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Examples

Request
Safe to Call
Reassigned

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

{
  "success": true,
  "results": [
    {
      "phone": "5039367187",
      "isReassigned": false,
      "hasSafeHarbor": true,
      "isSafeToCall": true
    }
  ]
}

{
  "success": true,
  "results": [
    {
      "phone": "5039367187",
      "isReassigned": true,
      "hasSafeHarbor": false,
      "isSafeToCall": false
    }
  ]
}

Usage Notes

Always provide the actual consent date, not the current date
A null result with hasSafeHarbor: true may still be safe to call under FCC safe harbor provisions

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes