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:

Name Description Example values
type MNP Lookup mnp
number Requested mobile number 491761234567890
0176-1234567890
00491761234567890

Optional parameters

Name Description Example values
json Return data as JSON 0 – Return only the network operator (default)
1 – Return a detailed JSON response

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

Plain text example

Please notice that you can only request one phone number at a time if you don’t use the JSON format.

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

Response:

d1

JSON example with a single number

Querying the MNP database as JSON with a single phone number returns one plain JSON object.

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

Response

{
    "code": 100,
    "mnp": {
        "country": "DE",
        "isPorted": false,
        "international_formatted": "+49 163 2429751",
        "mccmnc": "26201",
        "national_format": "01512 6716517",
        "network": "Telekom Deutschland GmbH (Telekom)",
        "number": "+4915126716517"
    },
    "price": 0.005,
    "success": true
}

JSON example with multiple numbers

Querying the MNP database as JSON with multiple phone numbers returns an array of JSON objects.

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

Response

[
  {
    "price": 0.005,
    "success": true,
    "code": 100,
    "mnp": {
        "country": "DE",
        "international_formatted": "+49 163 2429751",
        "isPorted": false,
        "mccmnc": "26201",
        "national_format": "01512 6716517",
        "network": "Telekom Deutschland GmbH (Telekom)",
        "number": "+4915126716517"
    }
  },
  {
    "price": 0.005,
    "success": true,
    "code": 100,
    "mnp": {
      "country": "DE",
      "international_formatted": "+49 162 5453093",
      "isPorted": false,
      "mccmnc": "26202",
      "national_format": "0162 5453093",
      "network": "Vodafone D2 GmbH (Vodafone)",
      "number": "+491625453093"
    }
  }
]