General HLR Lookup FAQs
We provide a few different ways to perform a HLR Lookup on your numbers:
- Instant Check
You can check the information on a single mobile number by using our instant checker page.
Simply enter your number into the search box in it’s international format and we’ll make a HLR Lookup and show you the result on the page.
- Batch Upload
If you have a large set of numbers to check, you can load them all in one file and well attach the results obtained back from the networks alongside your original data and ame available for download.
Include the mobile numbers you wish to check in our easy to use API and we’ll return the results in JSON enabling you to integrate easily.
For more detailed information on the various ways you can process numbers and the results you will see, take a look at the following pages:
For results that are within a batch there’s a specific Mobile/Landline column where all mobile numbers will be identified with the word Mobile.
In results that come from our API there’s a results field called type: which will indicate if your number is a mobile number.
If you ask us to perform a HLR Lookup on a non mobile number then we will flag this result with a Number Not Supported response.
You can always check the number type of a Number Not Supported result by using our free validator tool which distinguishes between Mobile numbers, Landline numbers and others such as Pagers and VoIP.
We’ve built our API to be as fast and robust as possible.
Total latency is mainly dependant on the network as we wait for a response from them before translating that response into your result.
On average though you should expect to see response times between 0.5 and 1.5 seconds.
Obviously the time it takes for a batch of numbers to complete depends on the amount of numbers contained in your file.
As a general rule you should expect 100,000 numbers to take about half an hour to complete.
All HLR Lookups are performed at the time of your request so all the responses you receive are in real time.
You have the option to use your own personal cache (up to 30 days) or our shared cache (up to 30 days) but this is entirely optional.
We will not use any cached results unless you specifically agree for us to do so.
For further information on utilising the cache please check out our Cache section of the knowledge base.
A HLR Lookup result does not provide the location of any phone number. You cannot use this service to track or trace mobile phones.
The most common reason for all numbers to be rejected is that you have selected the wrong column for us to check when you have uploaded your file.
You’re not charged for rejected numbers so just double check this and try again.
The Home Network is the network that the number currently belongs to. If a user has ported their number this will be different to the Issueing Network.
If the number you are checking is not LIVE then we are not able to provide any Home Network details.
MSISDN stands for Mobile Station International Subscriber Directory. It is just another name for a phone number.
Where you see this as a required field when using our API or Batch Upload facilities you should add the phone number you wish to check.
If you happen to check the same number that you have previously checked within 30 days and you are happy to just use the older result, then we won’t charge you for it. Just makes sure you have your Personal Cache levels set to 30 days (or whatever level you decide) and we’ll check the uploaded numbers against any you have previously uploaded first.
If you happen to check the same number as one of our other clients and they have allowed their results to be stored in the Shared Cache then we’ll just give you that result and only charge you half a credit.
If any other client uploads a number you have already had a result for then we will just give them that result and reward your account with half a credit.
Just be aware that this means if the result is found in either the Personal or the Shared Cache then we are not making a live real time lookup to the network operator so your results could be be slightly out of date (if the status of the number has changed within that time period).
We never share your results with anyone else unless you specifically tell us it is OK to add your results to the Shared Cache. And even then the user needs to also own the same number that you do for the result to be shared.
When all of the Cache settings are set to zero then every single one of your lookups are in real time to the network operator.
The Issueing Network is the network that originally allocated that number.
The Home Network is the network that the number currently belongs to.
If the 2 networks are different, this indicates the number has been ported.