1. Home
  2. Gateway
  3. HTTP Api
  4. MNP Lookup

MNP Lookup

Use our MNP (Mobile Number Ported) API to query the network operator of any international telephone number. Learn more about our number validation products.

Please issue the request to the following URL:
https://gateway.sms77.io/api/lookup

Required parameters

In addition to authentication, the following parameters are required:

Parameter Description Examples
type MNP Lookup mnp
number Requested mobile number 491761234567890
0176-1234567890
00491761234567890

Optional parameters

Parameter Description Examples
json Return data as JSON 1 – return JSON
0 – Only return operator (default)

Response

If the request is successful, the API returns one of the following values:

Return value Description
d1 Deutsche Telekom
d2 Vodafone
o2 o2
eplus E-Plus
N/A No porting information available. Check number if necessary
int International number

1. Example

Request:
https://gateway.sms77.io/api/lookup?p=api-key&type=mnp&number=491761234567890

Response:
d1

2. Example

Request:
https://gateway.sms77.io/api/lookup?p=api-key&type=mnp&number=4915126716517&json=1

Response

{
    "success": true,
    "code": 100,
    "mnp": {
        "country": "DE",
        "number": "+4915126716517",
        "international_formatted": "+49 163 2429751",
        "national_format": "01512 6716517",
        "network": "Telekom Deutschland GmbH (Telekom)",
        "mccmnc": "26201",
        "isPorted": false
    }
}
Was this article helpful to you? Yes No 3
Menu