# Valide cada número. antes Você envia.

- URL canónico: https://www.broadnet.me/pt/products/hlr-lookup
- Idioma: pt
- Última atualização: 2026-10-02
- Editor: BroadNet (https://www.broadnet.me)
- Versão Markdown da página, gerada a partir da página publicada.

Consulta HLR · Empresarial

Consulte o Registo de Localização Inicial de qualquer operadora em mais de 200 países. Obtenha informações de disponibilidade em tempo real, tipo de linha, a operadora proprietária do número atualmente e o status de roaming — para limpar listas, identificar fraudes e encaminhar o número pelo menor custo.

[Validar um lote de números](https://www.broadnet.me/pt/contact?topic=hlr-batch&product=hlr-lookup) [Fale com um engenheiro de telecomunicações.](https://www.broadnet.me/pt/contact?topic=telecom-engineer&product=hlr-lookup)

Mais de 200 países <50ms em cache 99,99% de tempo de atividade Em conformidade com o RGPD

![O leopardo-das-neves da BroadNet a verificar um número de telefone no registo da rede em tempo real](https://www.broadnet.me/marketing/generated/viz-hlr.png)

BroadNet · inteligência de números

POST /sms/lookup

200+

Países

~350ms

Mergulho ao vivo

MNP

Consciente

Em números

## Projetado para produção, medido em cada ciclo.

Cada consulta atinge o operador HLR em tempo real e devolve uma resposta com registo de data e hora que a sua aplicação pode auditar posteriormente.

Latência

~350ms

Resposta p99

Consulta HLR em tempo real, não um palpite baseado em cache.

Cobertura

200+

países

Todas as operadoras que publicam um HLR.

Portabilidade

MNP

consciente

Resolve a portabilidade dos números para o proprietário atual.

Conformidade

GDPR

+ UAE PDPL

O modo somente de pesquisa impede que os números sejam gravados no disco.

Como ocorre uma pesquisa

## De o seu MSISDN para Uma resposta HLR em tempo real, em cinco saltos.

Consultas SS7 MAP reais (ou Diameter, em núcleos 5G) contra o HLR da operadora de destino. Não um feed obsoleto de terceiros — o mesmo caminho que o nosso próprio router usa para avaliar cada SMS que enviamos.

1. 01 · Query POST /sms/lookup MSISDN em E.164. O endpoint em lote aceita até 10.000 números por chamada para execuções de higienização de listas. p50 < 40ms
2. 02 · Cache cache de 30 dias Os resultados em cache são devolvidos em menos de 50 ms, mantendo a mesma fidelidade de operador e status da porta. p50 < 50ms
3. 03 · MAP query SS7 MAP / Diameter Consulta HLR em tempo real encaminhada através da nossa rede SS7/Diameter para o HLR da operadora de destino. Mapa real, não um feed de dados de terceiros. p99 < 350ms
4. 04 · Resolve MCC + MNC + porto Devolve a operadora ativa (após a portabilidade), o país, o status da rede, o status de roaming, o prefixo IMSI e a disponibilidade. Tudo num único JSON. p50 < 20ms
5. 05 · Decision Use o resultado Defina a rota, defina a moeda, ignore números inativos antes que eles sejam cobrados. Essa mesma consulta alimenta o nosso próprio encaminhamento de SMS internamente. your call
6. ← MCC · MNC · port-status · reachability

01 · Query

POST /sms/lookup

MSISDN em E.164. O endpoint em lote aceita até 10.000 números por chamada para execuções de higienização de listas.

p50 < 40ms

02 · Cache

cache de 30 dias

Os resultados em cache são devolvidos em menos de 50 ms, mantendo a mesma fidelidade de operador e status da porta.

p50 < 50ms

03 · MAP query

SS7 MAP / Diameter

Consulta HLR em tempo real encaminhada através da nossa rede SS7/Diameter para o HLR da operadora de destino. Mapa real, não um feed de dados de terceiros.

p99 < 350ms

04 · Resolve

MCC + MNC + porto

Devolve a operadora ativa (após a portabilidade), o país, o status da rede, o status de roaming, o prefixo IMSI e a disponibilidade. Tudo num único JSON.

p50 < 20ms

05 · Decision

Use o resultado

Defina a rota, defina a moeda, ignore números inativos antes que eles sejam cobrados. Essa mesma consulta alimenta o nosso próprio encaminhamento de SMS internamente.

your call

Porque usar HLR antes de enviar?

## Quatro razões pelas quais se paga sozinho No primeiro dia.

### Prevenção de fraudes

Identifique clientes VoIP descartáveis, assinantes simulados e prazos de entrega antes que eles entrem no seu funil de vendas — ou pior, na sua fila de palavras-passe de uso único (OTP).

### Otimização de custos

Não pague para enviar mensagens para aparelhos inacessíveis. Uma consulta HLR custa uma fração do SMS que seria gasto e perdido.

### Inteligência de encaminhamento

Descubra a operadora atual (não a anterior) e escolha a rota direta. Os números portados são encaminhados corretamente na primeira tentativa.

### Auditoria de conformidade

Os resultados da pesquisa com registo de data e hora comprovam que o número foi validado e o consentimento foi dado no momento da adesão — o que é defensável de acordo com o GDPR e o PDPL.

100%

pista auditável

Capacidades

## Tudo o que você pediria à emissora, numa única chamada HTTPS.

### Consultas HLR em tempo real

Consulta SS7/SIGTRAN em tempo real ao HLR da operadora. Sem dados obsoletos, sem palpites probabilísticos — a resposta que você obtém é a resposta que a rede tem neste momento.

~350ms live <50ms cached

### MNP / deteção de portabilidade

Resolve a portabilidade de números para a operadora que efetivamente os atende atualmente. Essencial em mercados onde 25 a 40% dos números de telemóvel já foram portados pelo menos uma vez.

IMSI-aware current MNC

### Deteção de estado de roaming

Identifica assinantes que estão em roaming fora da sua rede doméstica. Útil para avaliação de fraudes, alertas de roaming e para evitar sobretaxas internacionais.

MSC / VLR data

### Enriquecimento em lote

Envie listas de até um milhão de MSISDNs por solicitação. Os resultados são transmitidos como NDJSON ou armazenados no seu bucket S3 como Parquet — prontos para o data warehouse.

1M / batch S3 + NDJSON

### Cache inteligente

O TTL (tempo de vida) por conta varia de 0 (sempre ativo) a 30 dias. Consultas repetidas dentro desse período são atendidas pelo cache de borda e cobradas de acordo com a taxa de cache.

0–30d TTL edge cached

### Nenhuma informação pessoal identificável armazenada.

O modo somente de pesquisa devolve a resposta e descarta a pergunta. Não há MSISDN em disco, nem registos contendo números de clientes, e o direito ao apagamento, conforme previsto no GDPR, é garantido por predefinição.

zero-retention GDPR Art. 17

Histórias de clientes

## Três equipas que transformaram a HLR em economias mensuráveis.

Operadora de nível 1 do GCC Telecomunicações · GCC AE

Desafio: Um mecanismo de faturação de interconexão precisava de informações numéricas confiáveis em alto volume sem pagar as tarifas integrais de consultas em tempo real. Abordagem: O HLR da BroadNet está integrado a um cache de assinantes ativos otimizado para o padrão de acesso do mecanismo de encaminhamento.

Engenheiro de interconexão responsável (referência sob acordo de confidencialidade)

grupo de operadoras móveis africanas Telecomunicações · África Subsariana NG KE UG

Desafio: Números inativos em várias listas de marketing africanas prejudicavam a entrega e inflavam os gastos. Abordagem: Uma execução de HLR em lote limpou as listas antes do ciclo de campanha seguinte.

Responsável por CRM e fidelização (referência sob acordo de confidencialidade)

Banco do Sul da Ásia Bancos · Sul da Ásia PK

Desafio: Os fluxos de registo digital perdiam contas para fraudes de divergência entre MSISDN e país. Abordagem: Cada MSISDN de registo é verificado via HLR em relação ao país declarado no formulário, e as divergências são sinalizadas para revisão manual.

Responsável pela prevenção de fraudes digitais (referência sob acordo de confidencialidade)

Pesquisa em lote

## Apague um milhão de números antes do almoço.

Envie a lista completa; nós a dividimos em grupos de 10.000 chamadas e transmitimos os resultados de volta em formato NDJSON, para que você possa integrá-los diretamente ao seu data warehouse.

Até 1,000,000 MSISDNs por lote

Resposta em fluxo contínuo — sem sondagem, sem chamadas de retorno.

S3, GCS, Azure Blob, Snowflake, coletores BigQuery

node.js python cURL

HLR · MNP

```
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";

const sms = new SMSSMSApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

// HLR / MNP lookup before sending: POST /sms/lookup
for (const destinationNumber of await readNumbers("./list.csv")) {
  const res = await sms.smsLookupPost({ destinationNumber });
  writeToWarehouse(destinationNumber, res.data);
}
```

Integrações

## Coloque-o lá. Em qualquer lugar.

### API REST

OpenAPI 3.1, autenticação por token Bearer, novas tentativas com jitter.

### Plugin SMPP

Inline HLR dip em cada vinculação MO/MT — sem alterações na aplicação.

### SDK oficial em TypeScript

@broadnet/cpaas-sdk para Node.js; gere um cliente para qualquer outra linguagem a partir da especificação OpenAPI 3.1.

### Plugin para Excel

Valide uma coluna de números sem escrever nenhum código.

Preços

## A partir de $0.003 por consulta em tempo real.

Os descontos por volume começam a partir de 100 mil consultas por mês. Os resultados em cache são cobrados a uma fração do preço original. Sem taxas de configuração, sem mínimos, cobrados em USD, EUR ou AED — os preços apresentados são indicativos.

[Validar um lote de números](https://www.broadnet.me/pt/contact?topic=hlr-batch&product=hlr-lookup) [Fale com um engenheiro de telecomunicações.](https://www.broadnet.me/pt/contact?topic=telecom-engineer&product=hlr-lookup)

Conformidade

## Projetado para órgãos reguladores Você precisa, de facto, satisfazer.

Médio Oriente e Norte de África (MENA), União Europeia (UE), Reino Unido — regras diferentes, uma necessidade em comum: comprovar que você verificou se o número estava ativo e quando. Cada pesquisa devolve um resultado com registo de data e hora que você pode arquivar como artefato de auditoria.

RGPD PDPL dos Emirados Árabes Unidos KSA PDPL TDRA CST NTRA ISO 27001

### GDPR e PDPL dos Emirados Árabes Unidos

O modo somente de consulta devolve a resposta e descarta o número. O tráfego da UE é isolado ao armazenamento da UE; o direito ao apagamento é exposto via API.

### Resultados com carimbo de data e hora

Cada pesquisa devolve um resultado com registo de data e hora que você pode anexar ao registo do utilizador como prova de validação no momento da adesão.

### conhecimento regulatório do Médio Oriente e Norte de África

A TDRA, a CST, a NTRA e outras entidades reguladoras da região MENA incentivam operadoras e remetentes a utilizarem dados de números limpos e verificados. Uma consulta HLR é o passo auditável que garante essa verificação.

### Operação alinhada com a ISO

Executado na mesma infraestrutura que a nossa plataforma de SMS A2P — ISO 27001, ISO 9001, ISO 22301. Registos à prova de adulteração, com retenção de 7 anos disponível.

Perguntas frequentes dos compradores

## Pesquisa HLR, respondeu em nome dos engenheiros.

Executamos consultas SS7 MAP e Diameter em tempo real no HLR real da operadora de destino — não num snapshot periódico do banco de dados MNP fornecido por um fornecedor. Isso significa que um número portado ontem regressa à sua nova operadora hoje, e não na próxima semana. A latência é maior (350 ms contra 20 ms em cache), mas a resposta é definitiva.

MCC (código do país), MNC (código da rede), operadora original, operadora atual (após a portabilidade), nome do país, tipo de rede (GSM/CDMA), país de roaming (se aplicável), prefixo IMSI, status de conectividade (ativo/inativo/desconectado) e um índice de confiança. Tudo numa única resposta JSON com menos de 1 KB.

Por consulta, com descontos significativos em cache. O plano padrão custa US$ 0,005 por consulta MAP em tempo real e US$ 0,0008 por acesso ao cache. Para mais de 5 milhões de consultas por mês, as tarifas corporativas caem para US$ 0,0028 em tempo real e US$ 0,0004 em cache. O endpoint em lote (até 10 mil números por chamada) não tem cobrança diferenciada — o mesmo preço por consulta se aplica.

O tempo de vida (TTL) padrão do cache é de 30 dias para números ativos e 7 dias para números inacessíveis. É possível ignorar o cache para cada solicitação individualmente, definindo `cache: false` no corpo da requisição, ou reduzir o TTL por conta nas configurações. O cache é isolado por conta; você nunca verá os dados em cache de outro locatário.

Cada envio de SMS, OTP e WhatsApp pode pré-verificar o HLR em linha (validate: true na solicitação de envio). Números inválidos devolvem um erro de API imediato em vez de serem cobrados e descartados silenciosamente. Muitos clientes também executam consultas em lote noturnas no seu CRM para limpar a lista antes do envio da campanha.

Sim — cada consulta devolve tanto a operadora original (do prefixo MSISDN) quanto a operadora atual (do HLR ativo). A comparação entre as duas é uma verificação de MNP de uma única linha. Não cobramos nenhum valor adicional pelas informações de MNP; elas fazem parte da resposta padrão.

A disponibilidade da API é garantida pelo SLA de 99,99% da plataforma, com p99 < 350ms para consultas em tempo real e p50 < 50ms para cache hits. Caso o tempo de atividade mensal fique abaixo do esperado, contratos enterprise recebem um crédito de serviço sobre a mensalidade (10% abaixo de 99,99%, 25% abaixo de 99,0%, 50% abaixo de 95,0%). Multi-região active-active — se uma região apresentar degradação, o tráfego é redirecionado em menos de 800ms.

A cobertura abrange mais de 200 países por meio de interconexões SS7 diretas e retransmissores parceiros. Alguns mercados (normalmente regimes regulatórios restritivos) devolvem apenas MCC/MNC a partir de dados de prefixo, e não HLR em tempo real. Nesses casos, a resposta devolve um indicador "degraded: true" para que a sua lógica possa lidar com a situação de forma adequada. A matriz de cobertura completa está disponível no painel de controlo.

A sua pergunta não está aqui? [Consulte a nossa equipa de engenharia](https://www.broadnet.me/pt/contact)

Combina bem com

## Valide e depois entregue.

[Number portability & routing The reference behind the lookup: MNP, routing numbers, All-Call-Query and HLR dips for least-cost routing. Saber mais](https://www.broadnet.me/pt/reference/number-portability-and-routing) [SMS A2P Após a validação do número, envie a mensagem através de mais de 1.000 interconexões diretas entre operadoras. Saber mais](https://www.broadnet.me/pt/products/a2p-sms) [OTP Palavras-passe de uso único multicanal com pré-validação HLR integrada para suprimir fraudes. Saber mais](https://www.broadnet.me/pt/products/otp) [Firewall SMS (para operadoras) Se você é uma operadora de telefonia móvel, o nosso firewall usa a mesma inteligência HLR para bloquear rotas cinzentas na velocidade da linha. Saber mais](https://www.broadnet.me/pt/operators/sms-firewall)

![O leopardo-das-neves da BroadNet ao lado de um fluxo de mensagens A2P a fluir para um telemóvel](https://www.broadnet.me/marketing/generated/viz-leopard-a2p.png)

Entrega de nível de operadora

## Entregue em mais de 200 países, direto para a operadora em 86 deles.

Sem rotas cinzentas: uma ligação direta ao operador sempre que esteja comercialmente disponível; caso contrário, uma rota gerida por um parceiro e identificada como tal. Uma única API para todos os canais, numa rede construída desde 2003.

200+

Países

1,000+

Conexões com operadoras

300M+

Msgs·dia

[Fale com o departamento de vendas.](https://www.broadnet.me/pt/contact)

Acesso de teste · resposta no prazo de um dia útil

## Valide o seu primeiro 1.000 números.

Solicite acesso para teste e responderemos em até um dia útil. Valide um lote de amostra e, em seguida, limpe as suas listas em produção assim que a sua conta for aprovada.

[Validar um lote de números](https://www.broadnet.me/pt/contact?topic=hlr-batch&product=hlr-lookup) [Fale com um engenheiro de telecomunicações.](https://www.broadnet.me/pt/contact?topic=telecom-engineer&product=hlr-lookup)

$ curl api.broadnet.me/sms/lookup

Recursos

Ficha técnica HLR Lookup

[Descarregar ficha técnica· PDF, 100 kB](https://www.broadnet.me/resources/datasheets/broadnet-hlr-lookup-datasheet.pdf) [Fichas técnicas de produto](https://www.broadnet.me/pt/resources)

## Guias e respostas relacionados

Aprofunde-se nos conceitos por trás deste produto.

- [O que é HLR Lookup Ler](https://www.broadnet.me/pt/answers/what-is-hlr-lookup)
- [Como funciona a verificação de números (OTP e 2FA) Ler](https://www.broadnet.me/pt/answers/number-verification)
- [Porque as minhas mensagens SMS não estão a ser entregues Ler](https://www.broadnet.me/pt/answers/why-are-my-sms-not-delivering)
- [Como posso reduzir os custos com SMS Ler](https://www.broadnet.me/pt/answers/how-to-reduce-sms-costs)
- [O que é MNP (Portabilidade Numérica Móvel) Ler](https://www.broadnet.me/pt/answers/what-is-mnp)
- [O que é um HLR (Registo de Localização Residencial) Ler](https://www.broadnet.me/pt/answers/what-is-hlr)

Também da BroadNet

MobileValidatePrévia privada

Precisa saber o tipo de linha de um número, ou as aplicações de mensagens nos quais ele pode receber, antes de enviar? A MobileValidate, uma marca BroadNet em prévia privada, verifica a operadora e o tipo de linha, aplicações como Telegram, Viber e RCS, e caixas de e-mail numa única solicitação API.

[Descubra a MobileValidate](https://www.broadnet.me/pt/products/mobilevalidate) [Aceda mobilevalidate.com (abre num novo separador)](https://mobilevalidate.com)
