Skip to main content
GET
GET
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

string
requerido
El id devuelto por la solicitud POST

Respuesta

200 — Búsqueda completada

object
Metadatos del lote
object
Estadísticas del lote
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 } }.
object
id y status: "ongoing"
object
Recuentos de finished y requested

Respuestas de error

Consulta Manejo de errores para ver la lista completa de códigos de estado y formatos de respuesta.

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.