Enviar Verificação (Upload de Arquivo)

POST/v1/detect/file

Envie um arquivo TXT ou CSV com um número por linha, máx 50 MB.

HTTP 202 Accepted

Parâmetros

Content-Type: multipart/form-data

Campo	Tipo	Obrigatório	Descrição
product	string	Sim	Slug do produto — Lista de Produtos
country	string	Obrigatório para telefone	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
file	file	Sim	Arquivo TXT ou CSV, um número por linha, máximo 50 MB.

Nota

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.

O campo country só existe nos produtos de telefone

E-mail não tem dimensão de país. Enviar country com um produto de e-mail falha na validação. É o espelho dos endpoints em tempo real, onde country é opcional mas deve ser omitido para e-mail.

Exemplo de Resposta

{
  "mode": "async",
  "task_id": "qH5rZ7Lp3Wm9",
  "idempotent_replay": false,
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

Campos da resposta

Enviar Verificação (Números)