1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. 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:

ParameterDescriptionExamples
typeMNP Lookupmnp
numberRequested mobile number491761234567890
0176-1234567890
00491761234567890

Optional parameters

ParameterDescriptionExamples
jsonReturn data as JSON1 – return JSON
0 – Only return operator (default)

Response

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

Return valueDescription
d1Deutsche Telekom
d2Vodafone
o2o2
eplusE-Plus
N/ANo porting information available. Check number if necessary
intInternational 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 1
Menu