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 | 4917612345678900176-123456789000491761234567890 |
Optional parameters
| Parameter | Description | Examples |
|---|---|---|
json | Return data as JSON | 1 – return JSON0 – 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
}
}