Obtenha um sinal de validade ou ativação por número em uma tarefa assíncrona de arquivo. Os resultados true/false apoiam a revisão de listas importadas, limpeza de dados e manutenção do CRM.
Este produto está disponível apenas como tarefa assíncrona com arquivo. A consulta de operadora em tempo real não retorna sinais de validade ou atividade.
O envio retorna um ID de tarefa imediatamente; consulte a tarefa por esse ID e, quando ela for concluída com sucesso, a resposta trará o link de download do arquivo de resultado. Cada solicitação é exibida com a respectiva resposta.
O ID da tarefa volta imediatamente com preparing definido como true enquanto o arquivo é preparado em segundo plano: linhas inválidas, duplicadas e — em tarefas de números — números sem código do país ou de outro país são removidos e não são cobrados. O saldo é reservado para as linhas enviadas e liquidado na conclusão; a diferença é reembolsada.
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}Consulte pelo ID da tarefa. Quando a preparação termina, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, em que total é o que é verificado e cobrado. Uma resposta de sucesso traz as contagens de sucesso e de falha e o link de download do arquivo de resultado; uma tarefa recusada durante a preparação fica como failed com reason_detail e é reembolsada integralmente.
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}A verificação em massa não é a verificação em tempo real em escala maior — você envia uma vez, ela roda em segundo plano e você coleta depois. Não é preciso manter a página aberta; o estado da tarefa e os resultados ficam no seu painel.
Um .txt ou .csv com um número por linha. Ele é transmitido diretamente; nada é gravado em disco.
Problemas óbvios (arquivo vazio, formato incorreto, poucas linhas) são rejeitados no envio. Em seguida, o saldo é reservado e o arquivo é preparado em segundo plano: linhas duplicadas e inválidas são removidas e a regra de país é verificada. Um arquivo que falha nessa etapa termina como tarefa com falha, reembolsada integralmente; caso contrário, apenas as linhas restantes são verificadas, e a tarefa é liquidada ao ser concluída.
A tarefa é executada sozinha — feche a página se quiser. Uma falha é informada imediatamente e reembolsada integralmente.
Obtenha o arquivo na página de verificação em massa. Você paga apenas pelos números que efetivamente retornaram resultado; a diferença é reembolsada.
O download é um único arquivo CSV com a tabela de resultados completa.
identifier · 12345678900 — O número enviado em dígitos simples com o código do país, sem sinal de mais nem espaços (ex.: 12345678900), e a chave estável para associar resultados a um cliente, lead ou registro do CRM. Mantenha-o para rastrear a lista de origem e gravar os resultados em massa; o campo por si só não comprova que o número pode ser contatado.activated · true — Decisão de validade/ativação: true é uma correspondência e false um negativo explícito. Não substitua resultados ausentes ou falhos por false. Não comprova identidade, permissão de contato ou disponibilidade para chamadas.Após importar cadastros ou leads, revise os resultados com dados do formulário, regras antifraude e consentimento. Esta análise assíncrona não substitui a verificação de códigos em tempo real.
Associe identifier ao registro original e preserve a origem para revisão manual.
Chave de associação: identifier
Após a exportação, marque os registros pelo sinal de ativação mantendo o número original e os campos de origem; encaminhe sinais ausentes ou incomuns para revisão em vez de excluir dados de negócio de imediato.
Separe true, false e resultados ausentes; mantenha os ausentes na fila de revisão.
Campo de segmentação: activated
Grave a data da verificação, o produto e o resultado em campos dedicados do CRM para que as equipes de marketing, atendimento e dados trabalhem com o mesmo status de lista nos fluxos seguintes.
Salve o resultado com a data da tarefa registrada pela equipe. Envie outra tarefa quando precisar atualizar.
Campos de atualização: identifier · activated
Verifique números E.164 em massa antes do contato e obtenha sinais de número e de ativação. Use o resultado para sinalizar registros para revisão, limpar listas e manter a qualidade dos dados do CRM; um sinal retornado não garante que uma chamada ou mensagem será completada.
True é uma correspondência e false um negativo explícito desta análise. Ambos são decisões retornadas; false não indica falha de execução nem linha gratuita. Trate resultados ausentes, indeterminados e falhos separadamente conforme as estatísticas e a liquidação final; não os preencha com false.
Não. Não há janela de observação, data da última atividade, frequência ou histórico de interação e nenhuma garantia de chamadas ou mensagens. Use o sinal com seus dados e a permissão de contato.
Este produto está disponível apenas como tarefa assíncrona com arquivo. A consulta de operadora em tempo real não retorna sinais de validade ou atividade.
A pré-verificação descarta as linhas malformadas, então elas nunca entram na contagem cobrável. Dos números restantes, os que o serviço de origem não consegue resolver também não são cobrados. Você paga apenas pelos números que efetivamente retornam resultado.
Depende da quantidade de números e do produto. Você pode fechar a página após o envio; a tarefa é executada em segundo plano e o resultado fica aguardando você na página de verificação em massa.
Sim. Uma tarefa com falha é reembolsada integralmente. Se a tarefa for bem-sucedida, mas alguns números não retornarem nada, essa parte é reembolsada automaticamente. A diferença entre o valor reservado e o valor efetivamente cobrado sempre é devolvida.
Consulta global de operadoraEnvie um arquivo inteiro de números: operadora, operadora subjacente, tipo de linha, país, região e cidade de cada um — os mesmos campos da consulta de operadora em tempo real.Atividade do númeroObtenha um sinal de atividade por número em uma tarefa assíncrona de arquivo. Combine true/false com seus registros de interação para revisar públicos e prioridades de acompanhamento.As verificações em massa e em tempo real usam o mesmo saldo — não há nada extra para ativar. Cadastre-se e envie seu primeiro arquivo na página de verificação em massa.