is_disconnected Tool - Contact Center Compliance

The is_disconnected tool checks in real-time if a phone number is disconnected or no longer in service. Use this to avoid wasting time calling invalid numbers.

When to Use

Before making calls to verify the number is still active
Cleaning up contact lists by removing dead numbers
Reducing wasted dial attempts and improving connect rates

Parameters

string

required

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

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

Response

boolean

Whether the API call succeeded.

string

The phone number checked.

string

C - Connected (number is active)
D - Disconnected (number is no longer in service)
U - Unknown (unable to determine)

string

Human-readable explanation of the status.

boolean

true if the phone number is currently connected.

boolean

true if the phone number is disconnected.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Examples

Request
Connected
Disconnected

{
  "phoneNumber": "5039367187"
}

{
  "success": true,
  "phone": "5039367187",
  "status": "C",
  "statusDescription": "Connected - phone number is currently active and in service",
  "isConnected": true,
  "isDisconnected": false
}

{
  "success": true,
  "phone": "5039367187",
  "status": "D",
  "statusDescription": "Disconnected - phone number is no longer in service",
  "isConnected": false,
  "isDisconnected": true
}

Usage Notes

This is a real-time check, providing current status
Disconnected numbers should be removed from your calling lists
Consider checking periodically for numbers that haven’t been reached
Reduces wasted dial attempts and improves campaign efficiency

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes