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. | 491632429751 00491632429751 0163-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 / success 0 / 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. | unknown ported not_ported assumed_not_ported assumed_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 / Success 2 / Partial success - some fields populated 0 / Failed |
valid_number |
Zeigt an, ob die Rufnummer existiert – nur für Mobilfunknummern möglich. | unknown valid not_valid |
reachable |
Ist die Rufnummer derzeit erreichbar? | unknown reachable undeliverable absent bad_number blacklisted |
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_line fixed_line_or_mobile mobile pager personal_number premium_rate shared_cost toll_free uan unknown voicemail voip |
Roaming Objekt
Parameter | Beschreibung | Mögliche Werte / Beispiel |
---|---|---|
status |
Der aktuelle Roamingstatus. | unknown roaming not_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":"not_roaming"
}