HLR + carrier lookup with MNP awareness

Un appel REST renvoie l'opérateur actuel, l'opérateur original (pré-portabilité), bool ported, type de ligne (mobile/fixe/VoIP/jetable), pays, MCC et MNC. P50 <100 ms via cache par E.164. Endpoint bulk pour listes froides.

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