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.

Error Text Descriptions

The Error Text column in your results .CSV gives you information on the current status of the number you have checked.

The Error Text wording directly relates to the Error Code and Status.

For example, anything marked as Live will always be Error Code 1 and Status Delivered

All other Error Texts and Error Codes do not reflect a Live a number and are therefore marked in the Status column as Undelivered

Error Text
Error Code
Status
Description
Credit Removed?

Live

0

Delivered

Active mobile number.*

Yes

Dead

1

Undelivered

Number decommissioned by the owning network.

Yes

Inconclusive

5

Undelivered

We are unable to retrieve a response from the network for this number.

Yes

No Credit

7

Undelivered

The account had insufficient funds to process this request.

No

No Teleservice Provisioned

11

Undelivered

This number is not able to receive calls or SMS messages.
This is usually a number relating to a data SIM.

Yes

Absent Subscriber

27

Undelivered

This number has not been active for a short period of time.

Please see box below for a more detailed description.

Yes

Number Not Supported

999

Rejected

This is an invalid number. Possible reasons include:
• The number does not contain a valid country code.
• The number does not contain a valid number range.
• The number is too long or too short.
• The number is a Landline number. ( this works differently for North America numbers, please see below )
• We have no coverage for the owning network of the number.

No

Absent Subscribers

There are three ways your number could be returned as Absent Subscriber:

  1. A prolonged period of inactivity.
  2. If a phone is turned off / Airplane mode and a call is made to that number. The HLR database will be updated to Absent Subscriber until a successful call has been made.
  3. The number has been allocated to a SIM card that has not yet been used and therefore never connected.

Alert

For some networks, only the MCC MNC information is available. In this instance all numbers checked belonging to one of these networks will be given a Delivered status

We advise all users to visit our Coverage Checker page before uploading numbers for processing.

North American numbers - Prefix 1

We'll identify if a number is a Landline but for those numbers recognised as Landline then we are unable to give an accurate status for that number.

In this instance all Landline numbers are given a an Error Text result of LIVE by default.