Porting Status Add-on

The Porting Status add-on allows you to find out if a phone number was ported or not and what carrier currently has the number. The information you get in a response includes the current MCC (mobile country code) and the current MNC (mobile network code).

Availability of Porting Status

TeleSign offers porting status information for phone numbers in these countries:

  • Afghanistan
  • Albania
  • Algeria
  • American Samoa
  • Andorra
  • Angola
  • Anguilla
  • Antigua and Barbuda
  • Argentina
  • Aruba
  • Australia
  • Austria
  • Bahamas
  • Bahrain
  • Bangladesh
  • Barbados
  • Belgium
  • Belize
  • Benin
  • Bermuda
  • Bhutan
  • Bolivia
  • Bosnia and Herzegovina
  • Botswana
  • Brunei Darussalam
  • Bulgaria
  • Burkina’Faso
  • Burundi
  • Brazil
  • Cape Verde
  • Cayman Islands
  • Central African Republic
  • Chad
  • Chile
  • China
  • Colombia
  • Comoros
  • Congo
  • Cook Islands
  • Egypt
  • Ethiopia
  • France
  • Germany
  • Ghana
  • India
  • Indonesia
  • Iran
  • Italy
  • Japan
  • Kazakhstan
  • Malaysia
  • Mexico
  • Morocco
  • Nigeria
  • Pakistan
  • Peru
  • Philippines
  • Poland
  • Russia
  • Saudi Arabia
  • South Korea
  • Spain
  • Taiwan
  • Thailand
  • Turkey
  • Ukraine
  • United Kingdom
  • United States
  • Vietnam

Example Request and Response for Porting Status

This section provides examples of a request with the porting status add-on and possible responses.

Porting Status Request
POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 08 Nov 2018 14:11:09 GMT
Content-Type: application/json 

    "addons": {
        "porting_status": {}

Here is an example of a successful response body:

Porting Status Successful Response Body
  "porting_status": {
    "mcc_current": "310",
    "mnc_current": "01",
    "ported": true,
    "status": {
      "code": 2800,
      "description": "Request successfully completed"

This is the response body when the request times out:

Porting Status Response Body for a Timeout
    "porting_status": {
        "status": {
            "code": 2811,
            "description": "Request processing timeout.",

Here is an example response body when the phone number is out of coverage. This means it is too far from a cellular antenna, in a restricted area that blocks signals, or it may be off.

Response Body When the Phone Number is Out of Coverage
  "porting_status": {
    "status": {
      "code": 2803,
      "description": "Phone number out of porting_status add-on coverage."
Porting Status Request Parameters

You must have you Technical Account Manager enable this feature for use. The addons parameter allows you to receive information returned from Contact, Contact Plus, Contact Match, or Number Deactivation, depending on which add-ons you enable. You receive add-on information back along with standard PhoneID information.

Porting Status Response

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.


One of the phone type codes.


Text describing the phone type.