Gateway

  2. Home
  4. Gateway
  6. HTTP API
  8. MNP Lookup

MNP Lookup

Fragen Sie über unsere MNP (Mobile Number Ported) API den Netzbetreiber einer beliebigen, internationalen Rufnummer ab. Lesen Sie mehr zu unseren Produkten zur Nummernvalidierung.

Richten Sie Ihren Request bitte an die URL
https://gateway.sms77.io/api/lookup

Benötigte Parameter

Zusätzlich zu den Daten zur Authentifizierung werden folgende Parameter benötigt:
Parameter Beschreibung Beispiele
type MNP Abfrage mnp
number Die abzufragenden Mobilfunknummern. Mehrere Einträge können per Komma getrennt werden – funktioniert nur, wenn Parameter json aktiviert ist. 491761234567890
0176-1234567890
00491761234567890
491761234567890,456789012345

Optionale Parameter
Parameter Beschreibung Beispiele
json Wenn der Wert gleich 1 ist, erfolgt eine detaillierte Antwort als JSON formatiert 0 – Liefert nur das Netz (standard)
1 – Rückgabe als JSON

Rückgabe

Bei erfolgreicher Anfrage liefert die API einen der folgenden Werte zurück:

d1
Deutsche Telekom
d2
Vodafone
o2
o2
eplus
E-Plus
N/A
Keine Portierungsinformation vorhanden. Ggf Nummer prüfen
int
Internationale Nummer

Beispiele

Text-Beispiel

In diesem Beispiel wird lediglich der Netzbetreiber in Form einer Zeichenkette zurückgegeben. Bitte beachten Sie, dass pro Anfrage nur eine Rufnummer verarbeitet werden kann. Für mehrere Rufnummern verwenden Sie bitte den Parameter JSON.

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=mnp&number=491761234567890

Antwort:
d1

JSON-Beispiel mit einer Rufnummer

Dieses Beispiel erfragt den Status für eine Rufnummer. Die API liefert ein einzelnes JSON-Objekt.

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=mnp&number=4915126716517&json=1

Antwort

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

JSON-Beispiel mit mehreren Rufnummern

In diesem Beispiel erfragen wir den Status zu mehreren Rufnummern. Die API antwortet mit einer Liste bestehend aus JSON-Objekten.

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=mnp&number=4915126716517,491625453093&json=1

Antwort

[
  {
    "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
    }
  },
  {
    "success": true,
    "code": 100,
    "mnp": {
      "country": "DE",
      "number": "+491625453093",
      "national_format": "0162 5453093",
      "international_formatted": "+49 162 5453093",
      "network": "Vodafone D2 GmbH (Vodafone)",
      "mccmnc": "26202",
      "isPorted": false
    }
  }
]