batch-status
Consulta el estado de un job iniciado con enrich-batch o contact-batch.
GET
/talent-scout/batch-statusConsulta el estado de un job iniciado con enrich-batch o contact-batch. Es el endpoint que vas a poll-ear en loop hasta que termine — un solo jobId cubre todo el lote, así que no hace falta consultar por candidato.
Query params
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobId | string | Sí | El jobId devuelto por enrich-batch o contact-batch |
curl "https://api.reclee.com/v1/talent-scout/batch-status?jobId=batch-contact-287de532-f86a-4fdf-8db9-ae044b5fe5f0" \
-H "Authorization: Bearer rk_live_TU_API_KEY"Posibles respuestas
| status | Significado |
|---|---|
QUEUED | En cola, todavía no arrancó |
PROCESSING | Al menos un candidato ya se procesó, otros siguen pendientes |
COMPLETED | Todos los candidatos se resolvieron con éxito |
PARTIAL | Terminó, pero al menos un candidato falló — revisá cada entrada en results |
FAILED | Todo el job falló |
done es true una vez que el job llega a COMPLETED, PARTIAL o FAILED. stalled pasa a true si un job que todavía no terminó no se actualizó en más de 2 minutos — vale la pena avisarle al usuario si lo ves.
Todavía procesando
{
"success": true,
"done": false,
"stalled": false,
"status": "PROCESSING",
"type": "CONTACT_UNLOCK",
"totalCount": 2,
"completedCount": 1,
"failedCount": 0,
"totalCreditsUsed": 0,
"results": {}
}Completado
{
"success": true,
"done": true,
"stalled": false,
"status": "COMPLETED",
"type": "CONTACT_UNLOCK",
"totalCount": 2,
"completedCount": 2,
"failedCount": 0,
"totalCreditsUsed": 0.7,
"results": {
"linkedin-a1b2c3d4": {
"status": "COMPLETED",
"workEmail": "marina.estevez@globant.com",
"personalEmail": "marina.e@gmail.com"
},
"linkedin-e5f6g7h8": {
"status": "COMPLETED",
"personalEmail": "juan.perez@gmail.com"
}
},
"companyCredits": 1198.67,
"companyExtraCredits": 300
}No encontrado / no es tuyo
{ "success": false, "done": true, "code": "BATCH_JOB_NOT_FOUND" }BATCH_JOB_NOT_FOUND significa que el jobId no existe, o que pertenece a una cuenta distinta de la que autentica tu API key.