Check if a phone number is live

From HLR Lookup, through Joshu Data Bodega.

Part of People & contact data phone live.

Price: $0.015 per call

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

usa_statusstring: YES, NO, optional
Set YES only for +1 numbers. Without it a US number returns NOT_AVAILABLE_NETWORK_ONLY. A US mobile with YES costs two credits.
input_formatstring, optional
ISO3 country code when telephone_number is in national format, e.g. GBR. Leave unset for international input.
output_formatstring, optional
Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code.
save_to_cachestring: PRIVATE, required
The result is cached only for this account, never shared.
telephone_numberstring, required
International E.164 digits without the leading +, or a national number with input_format.
cache_days_globalinteger: 0, required
0 never reads the shared cache, so the lookup is live.
cache_days_privateinteger: 0, required
0 never reads this account's cache, so the lookup is live.

Call it

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "hlrlookup.people.phone.verify",
    "params": {
      "save_to_cache": "PRIVATE",
      "telephone_number": "+14155550123",
      "cache_days_global": 0,
      "cache_days_private": 0
    }
  }'