Erhalten Sie über eine Abfrage in der HLR Datenbank ausführliche Informationen zu einer Mobilfunknummer. Die Abfrage ist für Nummern aus fast allen Ländern/Netzen weltweit möglich. 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 |
HLR Abfrage | hlr |
number |
Die abzufragende Nummer. Das Format ist nahezu beliebig – unser Gateway formatiert die Nummer automatisch korrekt. | 491632429751004916324297510163-2429751 |
Zur Überprüfung mehrerer Rufnummern in einem API Aufruf, geben Sie diese separiert jeweils durch ein Komma an. Sie erhalten ein JSON Array mit den jeweiligen HLR Ergebnissen zurück.
Rückgabe
Sie erhalten die HLR Informationen als JSON formatiert zurück. Bei ungültiger Nummer erhalten Sie ansonsten den Fehlercode 202, bei einem sonstigen Fehler bei der Abfrage den Code 600.
| Parameter | Beschreibung | Mögliche Werte / Beispiel |
|---|---|---|
status / status_message |
Statuscode / Statusnachricht der Abfrage. | 1 / success0 / error |
international_format_number |
Internationales Format der abgefragten Rufnummer. | 491632429751 |
international_formatted |
Internationale Rufnummer in formatierter Ausgabe. | +49 163 2429751 |
national_format_number |
Nationales Format der abgefragten Rufnummer. | 0163 2429751 |
country_code |
Ländercode der Rufnummer im Format ISO 3166-1 alpha-2 (zwei Buchstaben). | DE |
country_code_iso3 |
Ländercode der Rufnummer im Format ISO 3166-1 alpha-3 (drei Buchstaben). | DEU |
country_name |
Der vollständige Name des Landes der abgefragten Rufnummer auf englisch. | Germany |
country_prefix |
Landesvorwahl der abgefragten Rufnummer (international ohne führende „00“). | 49 |
ported |
Information über den Portierungsstatus der Rufnummer. Der vermutete Status beudetet, dass die Nummer laut HLR Abfrage nicht explizit portiert ist. | unknownportednot_portedassumed_not_portedassumed_ported |
current_carrier |
Der aktuelle Netzbetreiber der Rufnummer. | Carrier Objekt |
original_carrier |
Der ursprüngliche Netzbetreiber der Rufnummer. | Carrier Objekt |
lookup_outcome / lookup_outcome_message |
Zeigt an, ob alle Informationen zu der Rufnummer abgefragt werden konnten. | 1 / Success2 / Partial success - some fields populated0 / Failed |
valid_number |
Zeigt an, ob die Rufnummer existiert – nur für Mobilfunknummern möglich. | unknownvalidnot_valid |
reachable |
Ist die Rufnummer derzeit erreichbar? | unknownreachableundeliverableabsentbad_numberblacklisted |
roaming |
Aktueller Roamingstatus der Rufnummer. | Roaming Objekt |
gsm_code |
GSM Code der HLR Abfrage. | Siehe GSM Codes |
gsm_message |
Bedeutung des GSM Codes. | Siehe GSM Codes |
Carrier Objekt
| Parameter | Beschreibung | Mögliche Werte / Beispiel |
|---|---|---|
network_code |
Netzwerkcode des Netzbetreibers. Dies ist eine Komination von MCC und MNC. | 26203 |
name |
Name des Netzbetreibers. | E-Plus Mobilfunk |
country |
Ländercode des Netzbetreibers als ISO 3166-1 alpha-2 (zwei Buchstaben). | DE |
network_type |
Der Typ des Netzwerks der angeforderten Rufnummer. | fixed_linefixed_line_or_mobilemobilepagerpersonal_numberpremium_rateshared_costtoll_freeuanunknownvoicemailvoip |
Roaming Objekt
| Parameter | Beschreibung | Mögliche Werte / Beispiel |
|---|---|---|
status |
Der aktuelle Roamingstatus. | unknownroamingnot_roaming |
roaming_country_code |
Wird nur bei aktuellem Roaming zurückgeliefert. Ländercode des Roamingnetzwerks. | CH |
roaming_network_code |
Wird nur bei aktuellem Roaming zurückgeliefert. Netzbetreibercode (MCC + MNC) des Roamingnetzwerks. | 22803 |
roaming_network_name |
Wird nur bei aktuellem Roaming zurückgeliefert. Name des Netzbetreibers des Roamingnetzwerks. | Salt Mobile SA |
Es kann vorkommen, dass die Roaming-Abfrage “Kein Roaming” ergibt, obwohl die Nummer sich im Roaming befindet. Dies bedeutet in der Regel, dass Home Routing beim Netzbetreiber aktiviert wurde. Home Routing sorgt dafür, dass das Netz die Nummer als zu Hause meldet, unabhängig davon, wo sie sich gerade befindet.
Beispiel
Hier wird das HLR nach der Nummer 01632429751 durchsucht:
Request:
https://gateway.sms77.io/api/lookup?p=api-key&type=hlr&number=491632429751
Response:
{
"status_message":"Success",
"lookup_outcome":0,
"lookup_outcome_message":"Success",
"international_format_number":"491632429751",
"international_formatted": "+49 163 2429751",
"national_format_number":"0163 2429751",
"country_code":"DE",
"country_code_iso3":"DEU",
"country_name":"Germany",
"country_prefix":"49",
"current_carrier":{
"network_code":"26203",
"name":"E-Plus Mobilfunk",
"country":"DE",
"network_type":"mobile"
},
"original_carrier":{
"network_code":"26203",
"name":"E-Plus Mobilfunk",
"country":"DE",
"network_type":"mobile"
},
"valid_number":"valid",
"reachable":"reachable",
"ported":"assumed_not_ported",
"roaming":"not_roaming"
}