Gateway

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

Nummernformat Lookup

Fragen Sie das nationale und internationale Format beliebiger Mobilfunknummern ab. Zusätzlich erhalten Sie als Information den zugehörigen Netzbetreiber zu der Rufnummer (ohne Portierungsinformationen). Lesen Sie mehr zu unseren Produkten zur Nummernvalidierung.

Bitte richten Sie Ihren Request an folgende URL:
https://gateway.sms77.io/api/lookup

Benötigte Parameter

Zusätzlich zu den Daten zur Authentifizierung werden folgende Parameter benötigt:

Parameter Beschreibung Mögliche Werte
type Abfrage des Nummernformats format
number Die abzufragende Nummer. Mehrere Nummern müssen per Komma getrennt werden. Das Format ist nahezu beliebig – unser Gateway formatiert die Nummer automatisch korrekt. 0163-2429751
00491632429751
491632429751,491771783130

Rückgabe

Sie erhalten die Informationen als JSON formatiert zurück.

Parameter Beschreibung Mögliche Werte / Beispiel
success Abfrage erfolgreich true
false
international Internationales Format der abgefragten Rufnummer nach E.164. +491632429751
international_formatted Internationales Rufnummer in formatierte Ausgabe. +49 163 2429751
national Nationales Format der abgefragten Rufnummer. 0163 2429751
country_iso Ländercode der Rufnummer im Format ISO 3166-1 alpha-2 (zwei Buchstaben). DE
country_name Der vollständige Name des Landes der abgefragten Rufnummer auf englisch. Germany
country_code Landesvorwahl der abgefragten Rufnummer (international ohne führende „00“). 49
carrier Netzbetreiber, dem die Rufnummer ursprünglich zugewiesen war Eplus
network_type Der Typ des Netzwerks der angeforderten Rufnummer. fixed_line
fixed_line_or_mobile
mobile
pager
personal_number
premium_rate
shared_cost
toll_free
uan
unknown
voicemail
voip

Beispiele

Abfrage einer einzelnen Rufnummer

Hier wird das Format der Nummer 01632429751 abgefragt:

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

Antwort:

{
  "carrier": "Eplus",
  "country_code": "49",
  "country_iso": "DE",
  "country_name": "Germany",
  "international": "+491632429751",
  "international_formatted": "+49 163 2429751",
  "national": "0163 2429751",
  "network_type": "mobile",
  "success": true
}

Abfrage von mehreren Rufnummern

Hier wird das Format zweier Nummern 01632429751 und 01771783130 abgefragt:

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=format&number=491632429751,491771783130

Antwort:

[
  {
    "carrier": "Eplus",
    "country_code": "49",
    "country_iso": "DE",
    "country_name": "Germany",
    "international": "+491632429751",
    "international_formatted": "+49 163 2429751",
    "national": "0163 2429751",
    "network_type": "mobile",
    "success": true
  },
  {
    "carrier": "Eplus",
    "country_code": "49",
    "country_iso": "DE",
    "country_name": "Germany",
    "international": "+491771783130",
    "international_formatted": "+49 177 1783130",
    "national": "0177 1783130",
    "network_type": "mobile",
    "success": true
  }
]