> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# is_disconnected Tool

> Real-time check if a phone number is disconnected

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

<ParamField body="phoneNumber" type="string" required>
  10-digit North American phone number to check (e.g., `"5039367187"`).
</ParamField>

<ParamField body="loginId" type="string">
  API key. Only required if not provided via the `x-dncscrub-api-key` HTTP header.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the API call succeeded.
</ResponseField>

<ResponseField name="phone" type="string">
  The phone number checked.
</ResponseField>

<ResponseField name="status" type="string">
  * `C` - Connected (number is active)
  * `D` - Disconnected (number is no longer in service)
  * `U` - Unknown (unable to determine)
</ResponseField>

<ResponseField name="statusDescription" type="string">
  Human-readable explanation of the status.
</ResponseField>

<ResponseField name="isConnected" type="boolean">
  `true` if the phone number is currently connected.
</ResponseField>

<ResponseField name="isDisconnected" type="boolean">
  `true` if the phone number is disconnected.
</ResponseField>

<ResponseField name="errorCode" type="string">
  Machine-readable error code (when failed).
</ResponseField>

<ResponseField name="errorMessage" type="string">
  Human-readable error description (when failed).
</ResponseField>

## Examples

<Tabs>
  <Tab title="Request">
    ```json theme={null}
    {
      "phoneNumber": "5039367187"
    }
    ```
  </Tab>

  <Tab title="Connected">
    ```json theme={null}
    {
      "success": true,
      "phone": "5039367187",
      "status": "C",
      "statusDescription": "Connected - phone number is currently active and in service",
      "isConnected": true,
      "isDisconnected": false
    }
    ```
  </Tab>

  <Tab title="Disconnected">
    ```json theme={null}
    {
      "success": true,
      "phone": "5039367187",
      "status": "D",
      "statusDescription": "Disconnected - phone number is no longer in service",
      "isConnected": false,
      "isDisconnected": true
    }
    ```
  </Tab>
</Tabs>

## 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