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 |
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. | 0 / success1 / error |
international_format_number | Internationales Format der abgefragten Rufnummer. | 491632429751 |
international_formatted | Internationales Rufnummer in formatierte 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. | 0 / Success1 / Partial success - some fields populated2 / 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 |
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 |
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":{
"status":"not_roaming"
}
}