Via our Api you can request the MNP (Mobile Number Ported) status of any German mobile number. As a customer of sms77, this service is available to you free of charge. Learn more about our number validation products.
The number of queries is limited to 100 per month. If you need more queries, you are welcome to book our MNP flat rate. For this please contact us.
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
}
}