HLR Lookup API

Live phone number status from the mobile network.

Live phone number status from the mobile network. Pass +14156226819 and the operator's home location register answers directly: 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 network query, not a database, so it takes a couple of seconds and works worldwide on mobile numbers. Landlines have no HLR and answer not live. Junk answers valid: false as a 200, never a 404. null means the network did not answer the question, never no.

Lookup

GET

api.parseapi.com/hlr/{number}

Live status for a number. Optional ?country= (ISO2) for national formats

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

{
  "phone": "+14156226819",
  "valid": true,
  "country": "US",
  "live": true,
  "connected": true
}

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

{
  "phone": "+447712345678",
  "valid": true,
  "country": "GB",
  "live": true,
  "connected": false
}

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

{
  "phone": "+14155550199",
  "valid": true,
  "country": "US",
  "live": false,
  "connected": false
}

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

Counts against your plan's monthly HLR allowance. Free includes 50. Each lookup on a valid number uses one. A repeat on the same number within a day serves from cache and still uses one.

Questions? Email