GET /hlr/{number}

HLR lookup API

Pass a number. The network answers: alive, and switched on.

+14156226819live: true
phone switched offconnected: false
a dead numberlive: false

live

Number is assigned to a subscriber. false = dead number, null = the network did not answer

connected

Handset is reachable right now. false = switched off or out of coverage, null = unknown

1

Pass a number

Any country. E.164, or a national format with ?country=.

2

The network answers

A live HLR query to the operator, not a database. live and connected, two honest booleans.

3

Clean a list

Drop a phone CSV. Dead numbers surface before you dial or text them.

50 free a month.

One lookup per valid number. Worldwide.

Have a list?

Drop a phone CSV. Live status is a toggle on the quote. A penny and a half a number, $5 minimum.

Drop a CSV, Excel, or Numbers file

.csv, .xlsx, .xls, .numbers, .tsv, or a text list

Bulk phone validation

5
network verdicts
50
free lookups a month

Ask the network itself whether a number is real. Pass +14156226819 and the mobile network answers live: live says the number is assigned to a subscriber, connected says the handset is reachable right now. Carrier, line type, and ported live on /carrier.

This is a live HLR query, not a database. Worldwide, on any mobile number. Each lookup on a valid number uses one from your plan's monthly HLR allowance. Free includes 50. Landlines have no HLR and honestly answer not live.

RESPONSE

$ curl "https://api.parseapi.com/hlr/+14156226819" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~16ms · USA
{
  "phone": "+14156226819",
  "valid": true,
  "country": "US",
  "live": true,
  "connected": true
}

Response fields

phone
Normalized number (+ country code, no spaces), or null if invalid
valid
Number is valid
country
ISO 3166-1 alpha-2 country
live
Number is assigned to a subscriber. false = dead number, null = the network did not answer
connected
Handset is reachable right now. false = switched off or out of coverage, null = unknown

QUESTIONS

What is an HLR lookup?
A live query to the mobile network that owns the number. The network answers whether the number is assigned and whether the handset is reachable right now. Not a database.
What is the difference between live and connected?
live says the number belongs to a subscriber. connected says the handset is on and in coverage right now. A phone that is switched off is live: true, connected: false.
What about landlines?
Landlines answer the live question: assigned numbers come back live: true, dead ones live: false. connected stays null — reachability is a handset question landlines do not have.
What does null mean?
The network did not answer the question. null never means no.
What does a lookup cost?
One HLR lookup from the monthly allowance per valid number. Free includes 50. A repeat on the same number within a day serves from cache and still uses one.
Can I run a list?
Drop a phone CSV on /bulk. Live status is a toggle on the quote, priced per unique number. Dead numbers surface before you dial or text them.

SPEED

How long a lookup takes.

US

16ms

EU

18ms

APAC

69ms

LatAm

18ms

ME

126ms

See live status →

Get startedDocs