Developer Docs

Table of contents

MNP API

Mobile number portability (MNP) enables mobile phone users to retain their mobile telephone numbers when changing from one mobile operator to another.

Send MNP request

The method allows receiving the phone number portability status.

To send MNP, make a request to this URL:

PUT (POST) https://api.bsg.world/rest/mnp/create

Request parameters:

ParameterRequiredTypeDescription 
msisdnYesstringThe phone number to which the MNP request is sent.
tariffNointegerTariff number. The default is 0. An integer from 0 to 9.

If request is successful, you will receive a response:

{
   "result":true,
   "mcc":"255",
   "mnc":"06",
   "ported":false
}

Get MNP price

To get price on MNP, make a request to this URL:

GET https://api.bsg.world/rest/mnp/prices

If request is successful, you will receive a response:

{
   "error":0,
   "errorDescription":"No errors",
   "prices":[
      {
         "type":"mnp",
         "country":"",
         "country_name":"All countries",
         "mcc":"",
         "mnc":"",
         "price":"0.027",
         "currency":"EUR"
      }
   ]
}

Possible errors:

81 – Invalid MSISDN

82 – Country not supported

84 – Invalid payload