Gateway

  2. Home
  4. Gateway
  6. HTTP API
  8. 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 eine JSON-Liste mit den jeweiligen HLR-Objekten 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 Statuscode 1
0
status_message Statusnachricht der Abfrage. success
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 Zeigt an, ob alle Informationen zu der Rufnummer abgefragt werden konnten. 1
2
0
lookup_outcome_message Zeigt an, ob alle Informationen zu der Rufnummer abgefragt werden konnten. Success
Partial success - some fields populated
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 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:

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=hlr&number=491632429751

Antwort:

{
   "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"
}

Anfrage mehrerer Rufnummern

In diesem Beispiel werden mehrere Rufnummern angefragt. Die API antwortet mit einer Liste von JSON-Objekten.

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-schlüssel&type=hlr&number=491632429751,491771783130

Antwort:

[
	{
		"status": true,
		"status_message": "success",
		"lookup_outcome": true,
		"lookup_outcome_message": "success",
		"international_format_number": "491771783130",
		"international_formatted": "+49 177 1783130",
		"national_format_number": "0177 1783130",
		"country_code": "DE",
		"country_name": "Germany",
		"country_prefix": "49",
		"current_carrier": {
			"network_code": "26207",
			"name": "Telefónica Germany GmbH & Co. oHG (O2)",
			"country": "DE",
			"network_type": "mobile"
		},
		"original_carrier": {
			"network_code": "26207",
			"name": "Telefónica Germany GmbH & Co. oHG (O2)",
			"country": "DE",
			"network_type": "mobile"
		},
		"valid_number": "valid",
		"reachable": "reachable",
		"ported": "assumed_not_ported",
		"roaming": "not_roaming",
		"gsm_code": "0",
		"gsm_message": "No error"
	},
	{
		"status": true,
		"status_message": "success",
		"lookup_outcome": true,
		"lookup_outcome_message": "success",
		"international_format_number": "491632429751",
		"international_formatted": "+49 163 2429751",
		"national_format_number": "0163 2429751",
		"country_code": "DE",
		"country_name": "Germany",
		"country_prefix": "49",
		"current_carrier": {
			"network_code": "26207",
			"name": "Telefónica Germany GmbH & Co. oHG (O2)",
			"country": "DE",
			"network_type": "mobile"
		},
		"original_carrier": {
			"network_code": "26207",
			"name": "Telefónica Germany GmbH & Co. oHG (O2)",
			"country": "DE",
			"network_type": "mobile"
		},
		"valid_number": "valid",
		"reachable": "reachable",
		"ported": "assumed_not_ported",
		"roaming": "not_roaming",
		"gsm_code": "0",
		"gsm_message": "No error"
	}
]