HLR Lookup API
Query carrier networks directly from your application. Get live reachability, carrier, line type, and ported status, all through a single REST endpoint.
One endpoint. Everything you need.
POST /api/lookups
curl -X POST https://numtrue.com/api/lookups \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"number": "+14155551234"}'What you get back
{
"msisdn": "+14155551234",
"status": "active", // active | inactive | invalid | unknown
"reachable": true,
"network": "T-Mobile USA",
"lineType": "mobile", // mobile | landline | voip | toll_free
"country": "US",
"mcc": "310", "mnc": "260",
"isPorted": false,
"portedFrom": null,
"isDisposable": false,
"lookupMethod": "HLR", // HLR | MNP
"cost": 1
}Built for developers
Single REST endpoint
POST /api/lookups with a phone number. Get a complete JSON response in under 500ms.
Bearer token auth
Secure your integration with API keys. Manage and rotate keys from your dashboard.
Webhook support
Get batch results delivered to your server. No polling needed.
200+ countries
Global carrier coverage with automatic HLR or MNP routing based on destination country.
Pay per lookup
Only pay for billable results. Invalid numbers and failed lookups are free.
Clean JSON
No SOAP, no XML, no complexity. Standard REST with consistent response shapes.
Start integrating in minutes
REST API with simple JSON responses. SDKs, webhooks, and batch endpoints available.