The PhoneID Number Deactivation API determines whether a phone number has been deactivated, when, and by which carrier the phone number was deactivated based on carriers’ phone number data and TeleSign’s proprietary analysis. NOTE: If you try this API out using the API Explorer, you will be billed for the transaction as you normally would.

All requests submitted for the Number Deactivation API:

  • Can be authenticated with Basic (easiest to implement) and Digest
  • Use<complete_phone_number> as the base endpoint. The complete number includes the country code
  • Accept only UTF-8 encoded unicode characters as inputs
  • Use Content-Type - application/x-www-form-urlencoded in request headers

Request Parameters

1 Path Parameter
1 Query Parameter


Your request was fulfilled and resulted in a new resource being created. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response.

Status Code Associated Text String Description
300 Transaction successfully completed The system was able to obtain all of the requested data for PhoneID.
301 Transaction partially completed The system was able to obtain some of the data for PhoneID, but not all of it.

A 32-digit hex value used to identify the web service requests. The value is unique to each web service request, is randomly generated by TeleSign, and is returned in the response message immediately following the web service request.


A string displaying the subresource accessed. It is set to number_deactivation.


A JSON object that contains information about number deactivation for the specified phone number.


A JSON object that contains information on error conditions that might have resulted from the request, in an array of propery value pairs. If multiple errors occur, a pair is returned for each error.

Value Description
code A 1 to 5-digit error code (possibly negative) that indicates the type of error that occurred.
description A string that describes the type of error that occurred. If no errors occur, then this array is empty.

An object containing details about the request status.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
1 path param not set
1 variable not set