An HLR lookup is a real-time query to a mobile network's Home Location Register that tells you whether a mobile number is valid, which network it currently belongs to (MCC/MNC, after porting), and sometimes whether it is reachable or roaming. SMS senders use it to clean lists, route correctly and fight fraud.
What the HLR is
The Home Location Register is the database in a 2G/3G mobile core that holds each subscriber's profile and current status. In 4G and 5G networks the equivalent function is the HSS and the UDM, but the commercial service is still called "HLR lookup". A lookup provider sends a signalling query for the number and turns the response into a simple result.
What a lookup returns
| Field | Meaning |
|---|---|
| Status | Whether the number exists and is active, or unknown, unallocated or barred |
| Original network | The operator that owned the number range |
| Current network (MCC/MNC) | The operator now serving the number, after porting |
| Ported | Whether the number moved to another operator |
| Roaming | Whether the subscriber is abroad, and sometimes the visited network (not always available) |
| Reachability | Some providers report whether the phone is currently attached to the network |
The quality of results depends on the country and on how the provider queries the network. Some operators restrict these queries, and in some countries only portability data is available. Ask the provider what each field is based on.
HLR vs MNP vs number validation
- HLR lookup: live network query. Most complete, but slower (often a second or more) and more expensive.
- MNP lookup: checks a number portability database. Gives the current network, not whether the phone is active. Faster and cheaper.
- Number format validation: checks the number against the numbering plan, without any network query. Free, but only tells you if the format is plausible. See E.164 number format.
Why SMS senders use HLR lookups
- Correct routing: knowing the current network lets the platform pick the right supplier and the right rate. See MCC and MNC codes and number portability and routing.
- List cleaning: removing invalid and inactive numbers before a campaign avoids paying for messages that cannot be delivered, especially on per-submitted billing.
- Fraud checks: at sign-up, a lookup can flag numbers on unexpected networks or premium ranges, which helps against SMS pumping.
- DLR checking: numbers that the HLR shows as unallocated should never come back as delivered. If they do, suspect fake DLRs.
When not to use it
A lookup before every OTP adds latency and cost. For time-critical traffic, many senders rely on their SMS platform's own portability routing and run lookups only at registration, or on numbers that keep failing. For bulk lists, a lookup a short time before the campaign is usually enough, because number status changes slowly. Keep in mind privacy rules: a lookup processes personal data, so use it for a legitimate purpose and keep results only as long as needed.
Practical tips
- Compare two or three lookup providers on a sample of numbers you know, per country.
- Cache results for a limited time (days, not months) to save cost.
- Treat "unknown" separately from "invalid": some networks do not answer queries.
- Use lookup results together with DLR statuses to understand failures.
Routes and lookups
Many SMS routes already include portability routing on the supplier side. When you request A2P SMS routes through VoIPMatcher, tell us whether you need routing by current network in specific countries. Request an SMS route.
Frequently asked questions
Does an HLR lookup show the location of a phone?
No. An HLR lookup shows whether a number is valid and active, which network serves it, whether it was ported and sometimes whether it is roaming. It does not give the physical location of the phone. Legitimate lookup services are meant for routing, list cleaning and fraud checks, not for tracking people.
Is HLR lookup free?
Usually not. A real HLR lookup sends a signalling query to the mobile network, so providers charge per query. Free tools generally only check the number format against the numbering plan, which tells you whether a number is plausible but not whether it is active or which network serves it after porting.
Is HLR lookup legal?
Using a commercial HLR lookup service for a legitimate purpose, such as routing messages or cleaning a customer list, is a normal industry practice. The lookup processes personal data, so privacy rules apply: have a clear purpose, keep the results only as long as needed and do not use lookups to profile or track individuals.
What is the difference between HLR and VLR?
The HLR (Home Location Register) is the home network database that holds each subscriber's profile and status. The VLR (Visitor Location Register) holds temporary data about subscribers currently in the area served by a switching centre, including visitors from other networks. A commercial HLR lookup queries the home record, not the VLR.
What is an HLR lookup API?
An HLR lookup API lets your platform send a phone number and receive the lookup result as structured data, usually over HTTP. SMS platforms call it at sign-up, before a campaign or on numbers that keep failing. Compare providers on sample numbers you know, since result quality differs by country and by how each provider queries networks.
Need a route?
Send the destination, route type and target rate. We reply with what we can deliver.