Book a meeting with usBook a meeting

HLR Lookup API

HLR stands for: Home Location Register

The HLR is a database of all active customers of a mobile network, including their number, service entitlement, and number porting history.

What Data Does an HLR Lookup Provide?

  • Number’s affiliation to a mobile operator
  • Location by country and operator
  • The MCC, IMSI, MNC, and MSC of the number
  • Information on the number’s status (active, deactivated, or has never been registered)
  • Validation of the mobile number
  • The name of the network the number belonged to when it was first registered
  • Roaming information – the country and network the number is currently connected to
  • The identification of the network even if an error such as “Absent Subscriber” is returned

How to get started

  • Create free account at Text2reach
  • Contact us and submit your account name
  • We will activate HLR service to your account
  • Generate HLR API KEY within your Text2reach account
  • Integrate HLR API
  • Test our service using free credits available at your account
  • Start validating numbers on a global scale

📱  The pricing for Global coverage starts at 0.005 EUR per lookup. Please feel free to contact us for reseller pricing and rates for large volumes.

💻 Powerful API

Take our API and start validating mobile numbers in real time.

🌍 Worldwide Coverage

Extensive worldwide coverage for 220 mobile network carriers.

😎 No implementation fee

The service has no implementation or other fees.

📞 Live Support

Sign up for free. Support is Free. Testing is free. We’re always here to help with anything you may need.

💪 Try Us

We know you don’t know how valuable we are to your business without giving us a try first so all new accounts get free credits.

💰 Top-up & Credit Alert

We’ll get in touch when your credits are getting low. There’s no need to closely monitor your balance, we’ll do that for you.


HLR Lookups is a technology to check the status of any GSM cell phone number. By making a query to the Home Location Register, the lookup service determines whether that number is valid, whether it is currently active in a mobile network, and if so which network, whether it was ported from another network, and whether it is roaming. The query will also return meta information such as the IMSI, MSC, MCC and MNC.

With the emergence of Mobile Number Portability, cell phone subscribers can now keep their number when they change carriers.
This of course is highly convenient for customers, but it has also created a major challenge: now, it is much harder for businesses to guarantee the successful delivery of text messages, due to the quality of their customer database – it is often full of invalid or deactivated phone numbers. The result? A pricey waste of time and money. HLR Lookup is a service that gets around this.

HLR stands for Home Location Register. It is essentially a central global database of all the cellphone subscribers registered with a particular mobile network.
In is constantly updated in real-time, HLRs hold the most accurate, up-to-date information on any cell phone subscriber anywhere in the world. An HLR stores details of every SIM card the mobile phone operator issued. Each SIM has a unique identifier, called an IMSI, which is the primary key to each HLR record.

Information that can be obtained in real-time through HLR Lookups:

  • The name of the mobile network operator to which that number currently belongs
  • The country in which the network operator and the phone customer are located
  • The MCC (Mobile Country Code), the MNC (Mobile Network Code), IMSI (International Mobile Subscriber Identity) and MSC (Mobile Switching Center) of the phone number
  • Whether the number is currently active, has been deactivated, or was never registered — and therefore whether the number is valid or invalid
  • If so, the name of the network to which the number belonged when first registered
  • Whether a subscriber is roaming, which country they are roaming in, and what network they are currently logged on to (information obtained through the MSC address currently serving the number)
  • Whether the phone is switched on or temporary errors could prevent the delivery of an SMS — for example, if the phone is turned off or out of coverage for an extended time — referred to as an “Absent Subscriber”
  • The identification of the network even if an error such as “Absent Subscriber” is returned
  • Qualitative mobile number databases, removing invalid and deactivated numbers, enabling businesses to lower their costs by sending SMS texts to valid numbers only
  • Enhanced marketing function of an organization by allowing them to target an up-to-date database of customers, clients, alumni, or members
  • Better revenue margins and broader service coverage
  • Better service when roaming
  • Traffic facilitation and routing optimization for VOIP, SMS, and voice calls by determining a subscriber’s home network
  • Reduction of Mobile Number Portability issues and interworking fees to a minimum
  • Higher accuracy of network billing by identifying the network a mobile number currently belongs to
  • Real-time network information, including whether the number is ported
  • Troubleshooting SMS delivery problems
  • Distinction between invalid numbers, numbers experiencing a temporary problem, and handsets that are switched off

Our team is ready to answer any question!

Choose a suitable time and date for a remote conversation with a Text2reach consultant. When you book a time slot for the conversation, you’ll receive a Google calendar invitation with a link for your call in your e-mail. See you soon 😉