1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. 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:

ParameterBeschreibungMögliche Werte
typeHLR Abfragehlr
numberDie 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.

ParameterBeschreibungMögliche Werte / Beispiel
status / status_messageStatuscode / Statusnachricht der Abfrage.1 / success
0 / error
international_format_numberInternationales Format der abgefragten Rufnummer.491632429751
international_formattedInternationales Rufnummer in formatierte Ausgabe.+49 163 2429751
national_format_numberNationales Format der abgefragten Rufnummer.0163 2429751
country_codeLändercode der Rufnummer im Format ISO 3166-1 alpha-2 (zwei Buchstaben).DE
country_code_iso3Ländercode der Rufnummer im Format ISO 3166-1 alpha-3 (drei Buchstaben).DEU
country_nameDer vollständige Name des Landes der abgefragten Rufnummer auf englisch.Germany
country_prefixLandesvorwahl der abgefragten Rufnummer (international ohne führende “00”).49
portedInformation ü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_carrierDer aktuelle Netzbetreiber der Rufnummer.Carrier Objekt
original_carrierDer ursprüngliche Netzbetreiber der Rufnummer.Carrier Objekt
lookup_outcome / lookup_outcome_messageZeigt an, ob alle Informationen zu der Rufnummer abgefragt werden konnten.1 / Success
2 / Partial success - some fields populated
0 / Failed
valid_numberZeigt an, ob die Rufnummer existiert – nur für Mobilfunknummern möglich.unknown
valid
not_valid
reachableIst die Rufnummer derzeit erreichbar?unknown
reachable
undeliverable
absent
bad_number
blacklisted
roamingAktueller Roamingstatus der Rufnummer.Roaming Objekt

Carrier Objekt

ParameterBeschreibungMögliche Werte / Beispiel
network_codeNetzwerkcode des Netzbetreibers. Dies ist eine Komination von MCC und MNC.26203
nameName des Netzbetreibers.E-Plus Mobilfunk
countryLändercode des Netzbetreibers als ISO 3166-1 alpha-2 (zwei Buchstaben).DE
network_typeDer 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

ParameterBeschreibungMögliche Werte / Beispiel
statusDer aktuelle Roamingstatus.unknown
roaming
not_roaming
roaming_country_codeWird nur bei aktuellem Roaming zurückgeliefert. Ländercode des Roamingnetzwerks.CH
roaming_network_codeWird nur bei aktuellem Roaming zurückgeliefert. Netzbetreibercode (MCC + MNC) des Roamingnetzwerks.22803
roaming_network_nameWird 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"
   }
}
Was this article helpful to you? Yes 2 No 1
Menü