Saltar al contenido principal
GET
/
email
/
find
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}
GET 
https://api.enrow.io/email/find/bulk?id={id}
Recupera todos los resultados de una búsqueda masiva de correos usando el ID del lote. Autentica cada solicitud con tu clave de API en el encabezado x-api-key. El ID del lote es el id que se devuelve cuando inicias un trabajo con el endpoint Buscar correos.
Usar 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 — Búsqueda completada

​
general
object
Metadatos del lote
​
stats
object
Estadísticas del lote
​
results
array
Arreglo de resultados de búsqueda

​
200 — Búsqueda aún en curso

Mientras el lote se está ejecutando, el endpoint GET devuelve HTTP 200 con un cuerpo reducido de la forma { general: { id, status: "ongoing" }, stats: { finished, requested } }.
​
general
object
id y status: "ongoing"
​
stats
object
Recuentos de finished y requested

​
Respuestas de error

CódigoMensaje
400Could not retrieve bulk search 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/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}

​
Próximos pasos

Buscar correos en masa

Inicia un nuevo lote de hasta 5,000 búsquedas de correos.

Webhooks

Omite el sondeo y recibe una notificación cuando un lote se complete.

Créditos y facturación

Descubre cómo se cobran y se reembolsan los créditos por resultado.

Verificar correos en masa

Valida una lista de direcciones de correo en un solo lote.