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).

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
object
addons
object

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
object
reference_id
string

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.

phone_type
string

One of the phone type codes.

description
string

Text describing the phone type.

porting_status
object