HLR Phone Verification API

What it checks

An HLR (Home Location Register) lookup queries the live mobile network a number belongs to. Unlike format validation, which only checks the shape of a number, an HLR check talks to the network in real time. On every call it confirms the number is a mobile and tells you which network actually serves it now and which network it was ported from. Where the destination country supports it, the lookup also returns whether the handset is reachable right now: live, dead or out of network. You choose the response shape in the request: an easy summary with clean mapped booleans and labels you can act on immediately, or the full standard HLR response with the raw status codes for you to interpret. It's the same underlying data either way.

What it returns

• Confirmed mobile , confirmation that the number is a mobile MSISDN on a real network, returned on every call
• Current network , the network serving the number right now, after any porting, returned on every call
• Previous (ported-from) network , the network the number was originally allocated to or ported away from, with country and dialling prefix, returned on every call
• Reachability status (country-dependent) , live, dead or out-of-network status where the destination country supports it. This is not available everywhere. Ask us for the supported-country list
• Ported flag , whether the number has moved operator since it was allocated
• IMSI and MCC / MNC , subscriber identity and the mobile country/network codes identifying the serving network, where the network returns them

Ask us for the supported-country list: support@provero.io

How to read the result

An HLR response is about network provenance and, where the country supports it, reachability. Read it alongside what you intend to do with the number.

Mobile confirmed, on its original network

The cleanest result. The number is a mobile and hasn't moved operator. Use the current-network value for routing or pricing.

Mobile confirmed, ported

Fine to contact. The number simply moved operator; use the current-network value if your routing or pricing depends on the carrier, and the previous-network value for provenance.

Live / dead / out-of-network

Where the country supports reachability, this tells you whether the handset is reachable right now. Suppress dead and out-of-network numbers from time-sensitive campaigns; re-check later or remove.

Reachability not returned

For countries outside the supported-coverage list, you still get the mobile confirmation and network provenance, but not a live/dead status. Ask us for the supported-country list to see where reachability is available.

Pricing

from £0.0042 per request, down to £0.0023 at volume

Prepaid balance, spent across any check. Each request is charged at the rate for the volume band reached, and earlier requests keep their lower rate. See full pricing.

Need custom pricing? pricing@provero.io

API & bulk usage

Run HLR Phone Verification as a real-time API call at the point of capture, or upload a list for bulk cleaning before a campaign. Choose your response shape in the request: the easy summary returns clean mapped booleans and labels (live/dead/out-of-network where supported, plus current and previous network) you can act on immediately, while the full standard HLR response returns the raw status codes for you to interpret. It's the same underlying data either way. Roaming detection is not part of the standard response: it is an optional, application-gated add-on for fraud-screening use cases and must be applied for. You can call HLR on its own, or combine it with other checks in a single request and get every signal back in one response.

{
  "phone": {
    "phone": "447700900123",
    "route": "standard"
  }
}

{
  "phone": {
    "results": [
      {
        "to": "+447700900123",
        "status": "Live",
        "live": true,
        "dead": false,
        "outOfNetwork": false,
        "currentNetwork": "EE",
        "originalNetwork": "EE",
        "ported": false
      }
    ]
  }
}