ENG – Mobile Number Portability

MNP – Mobile Number Portability #

It is possible to request mobile number portability information via HTTP Rest Api through a call structured as follows:

• URL: https://mnp.agiletelecom.com/services/mnp/number-lookup?msisdn=number
• METHOD: GET
• AUTHENTICATION: Basic / Api-Key / OAuth1.1 (all in the header)

CAMPO	TIPO	NOTE
number	string	The telephone number for which the information is being requested. The initial “+” may be omitted, but the country code must still be specified as well.

The response will be in JSON format:

• 2XX (message accepted by the server)

{
  "number": "+39333123123",
  "mcc": "222",
  "mnc": "10",
  "numbertype": "mobile",
  "ported": false,
  "operator": "Vodafone",
  "country": "Italia"
}

FIELD	TYPE	NOTES
number	string	The telephone number for which information was requested.
mcc	string	Mobile Country Code currently associated with the requested number
mnc	string	Mobile Network Code currently associated with the requested number
numbertype	string	Fixed “mobile” string. Indicates the type of number requested
ported	boolean	Indicates whether the current operator of the requested number differs from the original
operator	string	Current operator of the requested number
country	string	Country currently associated with the requested number

• 4XX (request rejected due to formal errors in parameters)

{
  "error_code": 400
  "error_description": "Specify a msisdn number"
}

FIELD	TYPE	NOTES
error_code	integer	HTTP error code returned
error_description	string	Description related to the returned error code

• 5XX (request not processed due to server-side errors)

{
  "error_code": 500
  "error_description": "Server error"
}

FIELD	TYPE	NOTES
error_code	integer	HTTP error code returned
error_description	string	Description related to the returned error code