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.
Rode online
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.
Casos de uso
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.
Perguntas frequentes
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.
Para desenvolvedores — acesso via API
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.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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"]}'const res = await fetch("https://api.kit.forhosting.com/verify/phone-carrier", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/phone-carrier",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/phone-carrier", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/phone-carrier", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"items": [
"valor-1",
"valor-2"
]
}Exemplo de resposta
{
"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.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |