BroadNet
Fundamentals BroadNet answer

What is HLR Lookup?

Last reviewed 1 min readReviewed by BroadNet engineering
Quick answer

An HLR (Home Location Register) lookup is a real-time query against a mobile operator's subscriber database that returns whether a number is active, who owns it today (the original operator if ported, the current operator if not), what country it terminates in, and whether the subscriber is currently roaming. It is the single most useful number-quality check before sending an SMS.

Plain-language definitionVendor-neutralReviewed September 24, 2026
The long answer

Everything worth knowing, nothing that isn't.

§01

What the lookup actually does

An HLR Lookup request triggers an SS7 MAP-SRI-FOR-SM (or a SIP/IMS-equivalent on 5G) toward the recipient's home network. The response carries the IMSI, the serving MSC address, and the current MNC/MCC (which reveals roaming). It does not reveal the subscriber's location beyond country/operator granularity, and it does not deliver a message — it is the lookup step the SMSC would perform anyway, exposed as a standalone API.

§02

Why it matters commercially

Three reasons. You stop paying SMS fees on dead numbers (typically 8–18% of a stale marketing list). You route around ported numbers correctly — sending to a number's original operator when it has ported costs 40–60% more on some routes and increases failure rates. You catch numbers that are roaming and decide whether to charge the international rate or hold the send.

§03

Latency and limits

BroadNet's HLR Lookup API answers in about 350ms for a live query and under 50ms from cache, across 200+ countries, with batch endpoints for the once-a-week list scrub and a streaming endpoint for the before-every-send-OTP pattern. There is no fixed per-account lookup rate limit; throughput is sized to your traffic. See /products/hlr-lookup for the full spec.

§04

Privacy and compliance

HLR Lookup is regulated. In the EU under GDPR, an HLR query against a subscriber number is treated as personal data processing — you need a lawful basis. In KSA under PDPL 2023, MSISDN-level queries are also in scope. BroadNet's HLR Lookup endpoint logs only the hash of the queried number by default, with optional full-trace for customers in fraud-prevention use cases that have legal basis.

BNWritten by the BroadNet engineering team·Operating carrier-grade messaging since 2003, headquartered in Dubai·Editorial standards
Build with this

Need help wiring this up?

The pages below are the products and integration guides that put this concept on the wire. If you'd rather walk through it live, our engineering team takes calls same-day during MENA working hours.

Talk to our engineering team
Feedback

Was this answer helpful?

Your vote helps us prioritise which answers to expand with examples, diagrams, and code snippets.

Was this answer helpful?
Thanks — noted. We'll keep this answer maintained.
Got it. Tell us what was missing — send a quick note.

How we write and review content

Still need help?

Talk to a real engineer about your build.

We reply within one business day, and production accounts get 24/7 support. Our solutions engineers ship code, not scripts.

$ curl -X POST https://api.broadnet.me/sms/sendSms
Response SLA
Test-access requestsReply within 1 business day
Production24 / 7 · < 15 min
Operator NOC24 / 7 · pager