API Verificador de E-mail em Massa: Gmail, Outlook, Yahoo e mais

Verifique quais endereços de e-mail em sua lista enviada estão registrados em Gmail, Outlook, Yahoo, Mail.ru, or iCloud. Usa task_type email_check e o mesmo fluxo de polling em lote que outros verificadores.

Exemplo para enviar o arquivo de detecção:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./emails.txt"' \
--form 'task_type="email_check"'

Exemplo para consultar o status da tarefa:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Resposta para upload bem-sucedido:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2000,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Resposta para status de processamento:

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2000,
    "success": 800,
    "failure": 0
}

Resposta quando a tarefa for concluída (inclui a URL de download):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2000,
    "success": 2000,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL da requisição para upload de arquivo

POST https://api.checknumber.ai/v1/tasks

Parâmetros da requisição para upload de arquivo

Parâmetro	Descrição
`file`	`file`, um endereço de e-mail por linha
`task_type`	`string`, defina como `email_check`

URL da requisição para consultar status

POST https://api.checknumber.ai/v1/gettasks

Parâmetros da requisição para consultar status

Parâmetro	Descrição
`task_id`	`string`, ID da tarefa retornado na criação

Campos do resultado

O ZIP de resultado contém arquivos separados por provedor de e-mail. Cada linha inclui:

Campo	Descrição
`E-mail`	Endereço de e-mail
`Active`	Se o e-mail está registrado na plataforma (`true` / `false`)
`Provider`	Provedor de e-mail detectado: `gmail`, `outlook`, `yahoo`, `mailru`, `icloud`, or `unsupported`

Provedores suportados

Provedor	subtarefa `task_type`
Gmail	`email_gmail`
Outlook	`email_outlook`
Yahoo	`email_yahoo`
Mail.ru	`email_mailru`
iCloud	`email_icloud`

Tamanho mínimo do lote: 2.000 endereços de e-mail por tarefa.

Formato da resposta

Campo	Descrição
`created_at`	Timestamp quando a tarefa foi criada
`updated_at`	Timestamp da última atualização de status
`task_id`	Identificador único da tarefa
`user_id`	ID do usuário
`status`	`pending` · `processing` · `exported` · `failed` (reembolsado automaticamente)
`total`	Total de e-mails submetidos
`success`	E-mails verificados com sucesso
`failure`	Linhas que não puderam ser processadas
`result_url`	URL de download quando o `status` é `exported`
`actual_amount`	(Opcional) Valor efetivamente cobrado, disponível após a liquidação da tarefa
`estimated_amount`	(Resposta de criação) Valor estimado da tarefa; a cobrança final é liquidada na conclusão

Códigos de status

Status	Descrição
`200`	`free`, Solicitação bem-sucedida (ex.: consulta de status)
`202`	`charge`, Tarefa criada com sucesso; o valor estimado é deduzido
`400`	`free`, Solicitação inválida: parâmetros ou formato de arquivo inválidos, tipo de tarefa não suportado ou entradas válidas abaixo do lote mínimo
`401`	`free`, Chave de API ausente ou inválida
`402`	`free`, Saldo insuficiente
`404`	`free`, Tarefa não encontrada
`413`	`free`, Arquivo enviado muito grande
`500`	`free`, Erro interno do servidor, tente novamente mais tarde