Fluxo de Trabalho Típico

Envie um array de números de telefone para verificação. Processado assincronamente. O custo é pré-deduzido; números não verificados são reembolsados automaticamente.

Endpoints em resumo

Endpoints	Descrição
GET /v1/balance	Retorna o saldo USD atual da conta autenticada.
POST /v1/detect	Envie um array de números de telefone para verificação. Processado assincronamente. O custo é pré-deduzido; números não verificados são reembolsados automaticamente.
POST /v1/detect/file	Envie um arquivo TXT ou CSV com um número por linha, máx 50 MB.
GET /v1/tasks/{token}	Faça polling da tarefa até o status ser completed ou failed. Intervalo recomendado: 3–5 segundos.
GET /v1/tasks/{token}/result	Após concluída, recupere uma URL de download para o arquivo de resultado. Os arquivos são mantidos por 7 dias por padrão (controlado pela configuração result_retention_days).
GET /v1/tasks/{token}/download	Transmite o arquivo de resultados já concluído diretamente como anexo. Você pode seguir o download_url retornado pelo endpoint de resultado ou chamar este endpoint com o mesmo token de tarefa.

HTTP 202 Accepted

Antes de enviar

• O envio deve atingir o mínimo do produto selecionado — 500, 1,000 ou 2,000, dependendo do produto, exibido na lista de produtos em lote — e ficar abaixo do máximo da plataforma, de 2,000,000. Um envio abaixo do mínimo é rejeitado como too_few_numbers.
• Produtos de telefone: o código ISO 3166-1 alfa-2, por exemplo CN ou US. Produtos de e-mail: omita este campo por completo. — Códigos de país

Nota

A detecção em lote pré-debita o envio completo e, ao finalizar a tarefa, reembolsa automaticamente os números que ficaram sem verificação (pré-filtrados, duplicados ou não processados). Você paga apenas pelos números efetivamente processados.