# API de pesquisa HLR

> Validação MSISDN em tempo real — devolve operadora, país, status de portabilidade e se o número está ativo ou inativo. Cerca de 350 ms para uma consulta em tempo real e menos de 50 ms a partir do cache.

- URL canônico: https://www.broadnet.me/pt/developers/hlr-lookup
- Idioma: pt
- Última atualização: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)

Antes de enviar um número, verifique o status dele na rede (HLR e MNP) para limpar listas e lidar com números portados. Para isso, utilize o método POST /sms/lookup com o número como parâmetro de consulta destinationNumber; o parâmetro opcional reqType seleciona o tipo de pesquisa.

## Exemplos

### lookup

```bash
curl -X POST "https://api.broadnet.me/sms/lookup?destinationNumber=447700900123" \
  -H "Authorization: Bearer $BROADNET_TOKEN"
```

As integrações legadas podem usar GET /websmpp/hlr/lookup com as credenciais como parâmetros.