Saltar al contenido 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
Ejecuta varias verificaciones de email en una sola solicitud. Hasta 5.000 verificaciones por lote. Autentica cada solicitud con tu clave de API en el encabezado x-api-key. Para verificar una sola dirección en su lugar, usa el endpoint Verify Single Email.
Enrow realiza verificaciones deterministas que verifican incluso los emails catch-all. No se necesita ningún debouncer.

Cuerpo de la solicitud

verifications
array of strings
requerido
Array de direcciones de email a verificar.
custom
object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
settings
object
Ajustes relacionados con esta verificación en lote.

Respuesta

201 — Verificación en lote iniciada

message
string
Mensaje de confirmación
id
string
Identificador único de este lote. Úsalo para recuperar los resultados a través del endpoint GET.
credits_used
number
Total de créditos consumidos. Consulta Créditos y facturación para conocer los costes por endpoint.
estimated_duration
number
Tiempo de procesamiento estimado en minutos (no garantizado)
credits
object
Desglose de créditos

Respuestas de error

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
En caso de créditos insuficientes, el endpoint en lote devuelve 402 con el cuerpo { "message": "..." }. Consulta Gestión de errores para ver la lista completa de códigos de estado y formatos de respuesta.
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 pasos

Obtener los resultados

Recupera los resultados de verificación usando el id del lote.

Verificar un solo email

Comprueba si una dirección de email es válida y entregable.

Créditos y facturación

Consulta cómo se consumen los créditos en cada endpoint.

Webhooks

Recibe una notificación automática cuando un lote se complete.