Retrieve MCC and MNC information
GET/number-lookup?msisdn={msisdn}
By using MNP Number Lookup method, you can retrieve MCC and MNC information for specific phone number.
The MSISDN number must be provided in international E.164 format.
Example request:
curl -X 'GET' \
'https://mnp.example.com/horisen-mnp/v1/number-lookup?msisdn=525614157575' \
-H 'Authorization: Basic BASE64_API_KEY'
Every HTTP response has a status code sent back by the MNP HTTP Service to define how the HORISEN MNP Server has handled the response.
The most common statuses you may have encountered are 200 OK and 404 Not Found. Check out the list of the HTTP status codes to learn more en.wikipedia.org/wiki/List_of_HTTP_status_codes.
Unsuccessful Response should be sent only for the response with HTTP Status Code 500 Internal Server Error.
Please see the possible responses below. If you need support for additional HTTP Status Codes, please contact us and we will configure them accordingly.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 405
- 408
- 500
Successful number lookup response.
Bad Request.
Possible reasons:
- Missing MSISDN parameter
- Invalid request format
Unauthorized.
The provided API Key is invalid.
Payment Required.
The account balance does not contain sufficient credits.
Forbidden.
IP address is not whitelisted or has not the necessary permissions.
Not Found.
No information about MSISDN (MSISDN parameter is correct and complete).
Method Not Allowed.
The method is not supported in case if request URL was not correct.
Request Timeout.
You can use this HTTP Status Code when your MNP HTTP service is timed out or we can use default Timeout value (in seconds) on the MNP Server side.
Internal Server Error.
A generic error message, you can send also Unsuccessful Response with errorcode and errordesc. We will use this Response to send you notifications and you can check your MNP HTTP service logs to fix the errors.