ForHosting KIT · Validar e conferir

De qual operadora é esse número?

Esta consulta identifica a operadora associada a um número de telefone — informação que o próprio número não revela mais, já que a portabilidade quebrou a relação entre prefixo e operadora. Disponível via API, em beta: para operações de SMS, call centers e sistemas que precisam rotear ou precificar por operadora.

● Betapor itemUS$ 0,002
Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Prefixo não diz mais nada — e isso tem custo

Antes da portabilidade, o começo do número entregava a operadora. Hoje, milhões de linhas trocaram de dona levando o número junto, e qualquer tabela de prefixos vira chute. Para quem dispara SMS com preço diferente por operadora, roteia chamadas ou valida cadastros de recarga, errar a operadora é pagar mais caro ou entregar errado. A consulta resolve perguntando, em vez de adivinhar.

Como consultar e o que volta

Uma chamada de API por número: você envia o telefone (com DDD) e recebe um JSON com a operadora associada. O resultado entra direto na sua regra de negócio — escolher a rota de envio, preencher o campo “operadora” do cadastro, agrupar a base por operadora antes de negociar preço de disparo. Cada consulta custa US$ 0,002, paga por uso, sem mensalidade.

Beta: o que isso significa aqui

Esta capacidade está em beta: funciona e cobra o preço publicado, mas a cobertura e a precisão ainda estão em maturação — e a portabilidade faz o dado mudar com o tempo por natureza. Trate a resposta como forte indicativo, não como certeza absoluta, e conte que o comportamento pode ser ajustado enquanto o beta durar. Preferimos avisar isso na página a deixar você descobrir sozinho.

Custo de SMS sob controle

Quem negocia preço de disparo por operadora precisa saber quantos contatos tem em cada uma. Consultar a base antes da negociação transforma chute em número.

Campo “operadora” sem depender do usuário

Em cadastro de recarga ou de chip, o cliente frequentemente não sabe (ou erra) a própria operadora. A consulta preenche o campo com o dado real.

Roteamento de chamadas

Call centers que priorizam rotas por operadora usam a consulta para decidir o caminho de cada ligação antes de discar.

A consulta considera a portabilidade?

Sim — é justamente a razão de ela existir. A resposta reflete a associação atual do número, não a operadora original do prefixo. Como números continuam sendo portados todos os dias, o dado de hoje pode mudar amanhã.

Por que está em beta?

Porque ainda estamos maturando cobertura e precisão antes de tirar o selo. O preço já é o definitivo e está publicado; o selo beta é transparência, não desconto de responsabilidade.

Revela o nome do dono do número?

Não. A resposta é a operadora, e só. Nenhum dado do titular é consultado ou devolvido — o que mantém o uso alinhado à LGPD.

Funciona para número fixo?

O foco é celular, onde a portabilidade e o custo de disparo tornam o dado valioso. Para validar a estrutura de qualquer número, fixo incluído, existe o validador de telefone do KIT — esse, grátis no navegador.

Como eu pago?

Por uso: US$ 0,002 por consulta, via PayPal, sem plano nem franquia. Mil consultas somam US$ 2.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/verify/phone-carrier

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/verify/phone-carrier \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["valor-1","valor-2"]}'
{
  "items": [
    "valor-1",
    "valor-2"
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.phone_carrier",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →