Obtenha 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.
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_activity_batch \
-F country=US \
-F [email protected]200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_activity_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_activity_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), usado para gravar o resultado de atividade em uma lista, cliente ou registro de lead. Ele serve apenas para associação e rastreabilidade; não inclui horário de atividade, frequência nem detalhes de interação.activated · true — Decisão de atividade deste serviço: true é uma correspondência e false um negativo explícito. Sem data, contagem ou janela temporal. Interprete com seus registros; não prevê uma resposta.Grave o sinal retornado em tags de público e revise-o junto com o status recente de login, compra ou consentimento para criar grupos prontos para a revisão de acompanhamento.
Associe identifier ao registro original e preserve a origem para revisão manual.
Chave de associação: identifier
Antes de planejar a reativação, use o sinal e seus registros de interação existentes para definir prioridades de revisão; um sinal ausente não significa que a pessoa nunca responderá.
Separe true, false e resultados ausentes; mantenha os ausentes na fila de revisão.
Campo de segmentação: activated
Divida as listas por sinal, região ou estágio do cliente antes de definir conteúdo, frequência e cadência de contato diferentes para cada grupo e continue medindo seus próprios resultados de negócio.
Salve o resultado com a data da tarefa registrada pela equipe. Envie outra tarefa quando precisar atualizar.
Campos de atualização: identifier · activated
Envie uma lista de um único país e baixe identifier e activated ao concluir. O sinal auxilia a segmentação, mas não inclui janela de observação, data da última atividade nem contagem. Um resultado negativo isolado não identifica um cliente inativo.
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.Validação de número de telefoneObtenha 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.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.