Saltar al contenido principal
GET
/
email
/
verify
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}
GET
https://api.enrow.io/email/verify/bulk?id={id}
Recupera todos los resultados de una verificación masiva de correos utilizando el ID del lote. Autentica cada solicitud con tu clave de API en el encabezado x-api-key. Para iniciar un lote primero, usa el endpoint Verify Bulk Emails.
El uso de un webhook te permite omitir la llamada a este endpoint GET. Consulta Cómo funcionan los webhooks.

Parámetros de consulta

id
string
requerido
El id devuelto por la solicitud POST

Respuesta

200 — Verificación completada

general
object
Metadatos del lote
stats
object
Estadísticas del lote
results
array
Matriz de resultados de verificación

200 — Verificación aún en curso

Mientras el lote sigue ejecutándose, el endpoint devuelve un HTTP 200 con el estado del lote en lugar de los resultados completos.
general
object
Metadatos del lote
stats
object
Progreso del lote

Respuestas de error

CódigoMensaje
400Could not retrieve bulk verification results
Consulta Manejo de errores para ver la lista completa de códigos de estado y formatos de respuesta.
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}

Próximos pasos

Verificar correos en masa

Inicia una verificación por lotes y obtén el id del lote.

Verificar un correo

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

Webhooks

Recibe una notificación automática cuando un lote se complete en lugar de hacer sondeos.

Créditos y facturación

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