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
Name | Description | Example values |
---|---|---|
type |
MNP Lookup | mnp |
number |
Requested mobile number | 491761234567890 0176-1234567890 00491761234567890 |
Name | Description | Example values |
---|---|---|
json |
Return data as JSON | 0 – Return only the network operator (default)1 – Return a detailed JSON response |
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"
}
}
]