Skip to main content
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

​
phoneNumber
string
required
10-digit North American phone number to check (e.g., "5039367187").
​
loginId
string
API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

​
Response

​
success
boolean
Whether the API call succeeded.
​
phone
string
The phone number checked.
​
status
string
  • C - Connected (number is active)
  • D - Disconnected (number is no longer in service)
  • U - Unknown (unable to determine)
​
statusDescription
string
Human-readable explanation of the status.
​
isConnected
boolean
true if the phone number is currently connected.
​
isDisconnected
boolean
true if the phone number is disconnected.
​
errorCode
string
Machine-readable error code (when failed).
​
errorMessage
string
Human-readable error description (when failed).

​
Examples

{
  "phoneNumber": "5039367187"
}

​
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