Skip to main content
GET
/
v1.4
/
Data
/
RealTimeDisconnect
Checks real-time phone line status to determine if a number is connected or disconnected.
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.4/Data/RealTimeDisconnect
{
  "Status": "<string>",
  "ErrorText": "<string>",
  "Phone": "<string>"
}

​
Response

The API returns a JSON object with the following fields:
FieldDescription
PhoneTen digit phone number that was queried
StatusConnection status code (see table below)
ErrorTextDescriptive message when Status is ERROR

​
Status values

StatusDescription
connectedTypically connected
connected-75Connected 75% of the time
pendingNot completed yet
disconnectedTypically disconnected
disconnected-70Disconnected 70% of the time
busyBusy
unreachableNot reachable
invalid phonePhone not valid
restrictedCan’t be dialed
invalid-formatPhone or zip are not in a valid format
invalid-phonePhone number is not valid
bad-zip-codeZip code is not valid
serverunavailableServer unavailable - contact support
ERRORSee ErrorText parameter for error message

​
Example response

{
  "Phone": "5039367187",
  "Status": "connected",
  "ErrorText": ""
}

Headers

​
loginId
string

LoginId (aka APIKey)

Query Parameters

​
phoneNumber
string

The 10-digit phone number to check

Response

Success

​
Status
string | null
​
ErrorText
string | null
​
Phone
string | null