HLR + carrier lookup with MNP awareness

One REST call returns live carrier, original carrier (pre-portability), ported bool, line type (mobile / fixed / VoIP / disposable), country, MCC and MNC. P50 under 100 ms via per-E.164 carrier-aware caching. Bulk endpoint for cold-list scoring.

Sample response

{
  "e164": "+447700900123",
  "carrier": "EE",
  "carrier_original": "Vodafone UK",
  "ported": true,
  "line_type": "mobile",
  "country": "GB",
  "mcc": 234,
  "mnc": 30,
  "ttl_s": 86400
}

Endpoints

GET /api/v1/numbers/{phone}/hlr — single lookup
POST /api/v1/numbers/batch-hlr — up to 1,000 numbers per call
GET /api/v1/numbers/{phone}/everything — HLR + rating + antifraud + registration timeline in one shot

Why MNP-awareness matters

In number-portability countries (US, UK, EU, BR, IN, MX, etc.) the SMS-routing operator changes when a subscriber ports out, while the number-block prefix still maps to the original carrier. Static MCC/MNC databases get the original carrier; an HLR lookup gets the current one. Routing on the original carrier means paying to send to a network that will silently drop the SMS.

HLR + carrier lookup with MNP awareness

Sample response

Endpoints

Why MNP-awareness matters

Related