HLR + carrier lookup with MNP awareness

Uma chamada REST retorna operadora atual, operadora original (pré-portabilidade), bool ported, tipo de linha (móvel/fixo/VoIP/descartável), país, MCC e MNC. P50 <100 ms via cache por E.164. Endpoint em massa para listas frias.

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