Saltar para o conteúdo principal
POST
/
email
/
verify
/
bulk
curl --request POST \
  --url https://api.enrow.io/email/verify/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "verifications": [
      "pam.beesly@dundermifflin.com",
      "angela.martin@dundermifflin.com",
      "stanley.hudson@dundermifflin.com"
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/verify"
    }
  }'
{
  "message": "Bulk verification operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 0.75,
  "estimated_duration": 1
}
POST
https://api.enrow.io/email/verify/bulk
Execute várias verificações de e-mail em uma única requisição. Até 5.000 verificações por lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. Para verificar um único endereço, use o endpoint Verificar E-mail.
A Enrow realiza verificações determinísticas que verificam até mesmo e-mails catch-all. Nenhum debouncer é necessário.

Corpo da Requisição

verifications
array of strings
obrigatório
Array de endereços de e-mail a verificar.
custom
object
Parâmetros personalizados que serão retornados na resposta GET e na notificação por webhook.
settings
object
Configurações relacionadas a esta verificação em lote.

Resposta

201 — Verificação em lote iniciada

message
string
Mensagem de confirmação
id
string
Identificador único para este lote. Use-o para recuperar os resultados por meio do endpoint GET.
credits_used
number
Total de créditos consumidos. Consulte Créditos e cobrança para os custos por endpoint.
estimated_duration
number
Tempo estimado de processamento em minutos (não garantido)
credits
object
Detalhamento de créditos

Respostas de Erro

CodeMessage
400Missing payload
400At least 1 verification must be present in the payload
400Too many verifications. Limit is currently at 5000 per batch.
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
Em caso de créditos insuficientes, o endpoint em lote retorna 402 com o corpo { "message": "..." }. Consulte Tratamento de erros para a lista completa de códigos de status e formatos de resposta.
curl --request POST \
  --url https://api.enrow.io/email/verify/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "verifications": [
      "pam.beesly@dundermifflin.com",
      "angela.martin@dundermifflin.com",
      "stanley.hudson@dundermifflin.com"
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/verify"
    }
  }'
{
  "message": "Bulk verification operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 0.75,
  "estimated_duration": 1
}

Próximos passos

Obter os resultados

Recupere os resultados da verificação usando o id do lote.

Verificar um único e-mail

Verifique se um endereço de e-mail é válido e entregável.

Créditos e cobrança

Veja como os créditos são consumidos para cada endpoint.

Webhooks

Seja notificado automaticamente quando um lote for concluído.