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

phoneNumbers

array

required

Array of objects containing phone numbers and consent dates.

Show phoneNumber object

phoneNumber

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

success

boolean

Whether the API call succeeded.

results

array

Array of results, one per phone number.

Show result object

phone

string

The phone number checked.

isReassigned

boolean | null

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

hasSafeHarbor

boolean

Whether FCC safe harbor exemption may be available.

isSafeToCall

boolean

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

errorCode

string

Machine-readable error code (when failed).

errorMessage

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

MCP Server for AI Applications

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes