Skip to main content
GET
GET
Recupere todos os resultados de uma busca de e-mails em lote usando o ID do lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. O ID do lote é o id retornado quando você inicia um trabalho com o endpoint Find Bulk Emails.
Usar um webhook permite que você dispense a chamada a este endpoint GET. Consulte How Webhooks Work.

Parâmetros de Consulta

string
obrigatório
O id retornado pela requisição POST

Resposta

200 — Busca concluída

object
Metadados do lote
object
Estatísticas do lote
array
Array de resultados da busca

200 — Busca ainda em andamento

Enquanto o lote está em execução, o endpoint GET retorna HTTP 200 com um corpo reduzido no formato { general: { id, status: "ongoing" }, stats: { finished, requested } }.
object
id e status: "ongoing"
object
Contagens de finished e requested

Respostas de Erro

Consulte Error handling para a lista completa de códigos de status e formatos de resposta.

Próximos passos

Encontrar e-mails em massa

Inicie um novo lote de até 5.000 buscas de e-mail.

Webhooks

Dispense o polling e seja notificado quando um lote for concluído.

Credits & billing

Veja como os créditos são cobrados e reembolsados por resultado.

Verificar e-mails em massa

Valide uma lista de endereços de e-mail em um único lote.