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 carrier provision/connect/disconnect numbers, no service will guarantee 100% accuracy. 

This API requires an API key from SmartCarrier.  If you do not have an API key, please contact [e-mail] for assistance.  

---

Web Service Information
Endpoint:	https://api.smartcarrier.io/v2/disconnected-number-check?
Method:	GET
Parameter:	TelephoneNumber
Header:	x-api-key
Example:	https://api.smartcarrier.io/v2/disconnected-number-check?TelephoneNumber=3155564800

Sample Response
JSON Response:	{ "RequestGuid": "fe18ff43-dc11-4a54-85af-4a2500d7f4b2", "AccountGuid": "320d3f42-a289-4f96-9f44-7ddb8e24bc89", "PhoneNumber": "3155564800", "E164FormattedNumber": "[phone]", "CountryCode": "NANPA", "ConfidenceScore": 0, "RequestingIP": 127.0.0.1, "RequestedAt": "2024-09-12T22:43:54.2419316Z", "CompletedAt": "2024-09-12T22:43:54.5784732Z", "ApplicationVersion": "4", "ReturnStatus": "Success", "ReturnCode": 200 }

What do These Values Mean?
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.