Disconnected Number API

The Disconnected Number API is a JSON-compliant web service that will check if a telephone is in service or not in service based on the carrier’s confidence score. Based on historical data, this API will render a result that is 98% accurate. Due to how carriers provision, connect, and disconnect numbers, no service will guarantee 100% accuracy.

This API requires an API key. Find your key on the Organization settings page of the Smart Carrier dashboard. If you cannot find it, contact support@smartcarrier.io.

Web service information

Field	Value
Endpoint	`https://api.smartcarrier.io/v2/disconnected-number-check?`
Method	`GET`
Parameter	`TelephoneNumber`
Header	`x-api-key` (get your API key)
Example	`https://api.smartcarrier.io/v2/disconnected-number-check?TelephoneNumber=3155550100`

Sample response

{
  "RequestGuid": "11111111-2222-3333-4444-555555555555",
  "AccountGuid": "12345678-1234-1234-1234-123456789012",
  "PhoneNumber": "3155550100",
  "E164FormattedNumber": "+13155550100",
  "CountryCode": "NANPA",
  "ConfidenceScore": 0,
  "RequestingIP": "203.0.113.10",
  "RequestedAt": "2025-01-01T12:00:00.0000000Z",
  "CompletedAt": "2025-01-01T12:00:00.5000000Z",
  "ApplicationVersion": "4",
  "ReturnStatus": "Success",
  "ReturnCode": 200
}

What do these values mean?

Field	Description
`RequestGuid`	A unique identifier assigned to this request.
`AccountGuid`	The account associated with this request.
`PhoneNumber`	The phone number requested.
`E164FormattedNumber`	The E.164 representation of the telephone number requested.
`CountryCode`	The country the phone number is associated with.
`ConfidenceScore`	A value between 0 and 5. 0–2: Telephone number is most likely disconnected. 3: This number may not be in service, as very little activity has been observed. 4–5: This number is most likely in service.
`RequestingIP`	The IP which initiated the request.