HLR Lookup Documentation

The HLR Lookup Developer Hub

Welcome to the HLR Lookup help pages. Here you'll find all the information you need to get started with our API or batch upload services.
Search the docs for explanations on the results you'll receive and a breakdown of all the possible parameters available.

Valid Mobile Numbers

issueing_info
Info
Field Type

verified

Expect: true Indicates that this is a valid mobile number

Boolean

timezone

Timezone of the country where the original network is located

String

location

Country of the original network for this number

String

network_name

The name of the originating network

String

country_code

The country code of the location of the orginal network

Integer

area

Country of the the original network for this number

String

Note

These fields will be populated regardless of the status of the number.

home_info
Info
Field Type

verified

Expect: true Indicates that this is a valid mobile number

Boolean

timezone

Timezone of the country where the current network is located

String

location

Home country of the current network for this number

String

network_name

The name of the current network

String

country_code

The country code of the location of the current network

Integer

Note

These fields are only populated when the number sent for checking is flagged as live.

roaming_info
Info
Field Type

verified

Expect: true Indicates that this is a valid mobile number

Boolean

timezone

Timezone of the country where the number is currently located

String

location

Which country the number is currently located

String

network_name

The name of the network that the SIM is currently roaming on

String

country_code

The country code of the current location of the number

Integer

area

Which country the number is currently located

String

Note

These fields are only populated when the number sent for checking is flagged as live .

Status Information
Info
Field Type

type

Expect Mobile

String

msisdn

The number used for the lookup

String

error_code

For more details check the Status Information page.

Integer

error_text

For more details check the Status Information page.

String

status

Expect: Delivered ,Undelivered or Rejected

String

mccmnc

The MCC and MNC identify the Mobile Country Code and Mobile Network Code

String

is_ported

Will indicate if the number has been ported from it's Original Network to a different Current Network

Boolean

is_roaming

Will indicate if the number is currently roaming outside of it's home location

Boolean

Tip

An error code of 0, an error text of Live and a status of Delivered all mean the number is live and contactable.

For more details of the other Error Codes possible see the next page.