HLR Lookup

Get detailed information about a mobile phone number with a query in the HLR database. The query is possible for numbers from almost all countries/networks worldwide. Read more about our number validation products.

Please issue the request to the following URL:
https://gateway.sms77.io/api/lookup

Required parameters

In addition to the data for authentication, the following parameters are required:

To check multiple phone numbers in an API call, enter each number separated by a comma. You will receive a JSON array with the respective HLR results.

Response

You get back the HLR information in a JSON formatted form. If the number is invalid, you’ll receive the error code 202. If other errors occur you’ll receive the code 600.

Carrier object

Roaming object

Example

Here the HLR database is searched for the number 01632429751:

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