1. Home
  2. Gateway
  3. HTTP Api
  4. HLR Lookup

HLR Lookup

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

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 Netzwerk die Nummer als am Heimatstandort 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"
}
Fandest du diesen Artikel hilfreich? Ja 3 Nein 1
Menü