Lee un proceso con el id que Human Plugin devolvió al crearlo.
GET /v1/processes/{id}
id es el UUID de la respuesta de creación. No hay encabezado de autenticación ni restricción por cliente: cualquier llamador que pueda alcanzar Human Plugin puede leer cualquiera de sus procesos.
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
Cuándo llega el resultado
- Un proceso pendiente (
PROCESS_STATE_CREATED) se verifica en cada lectura y se responde con su resultado en cuanto hay uno. - Un proceso finalizado o fallido es definitivo y se responde tal cual.
- Una creación que fue interrumpida se responde como fallida unos 70 segundos después de haber comenzado.
La lectura es la única forma de que un proceso pendiente avance: no hay ningún job en segundo plano, y el retorno a tu callbackUri no actualiza Human Plugin.
Respuesta
200 OK con la misma estructura que una creación: id, state y data.
Un Journey pendiente:
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
Procesos finalizados y fallidos
Un proceso finalizado devuelve su resultado en data: quién es la persona, en humanToken, y la inteligencia de la persona, en ndocs, además de liveness cuando el flujo lo verifica. Una revalidación devuelve humanTokenMatch en lugar de humanToken. Cada campo se describe en El resultado en data. Un proceso fallido devuelve PROCESS_STATE_FAILED con un data vacío.
Un proceso finalizado:
{
"id": "b063041c-7529-4e70-a2b4-c71c00f19801",
"state": "PROCESS_STATE_FINISHED",
"data": {
"humanToken": { "value": "6d3d71…", "status": "validated" },
"liveness": { "value": "live", "status": "validated" },
"ndocs": {
"distinctClientsCount": 2,
"transactionsCount": 3,
"firstSeen": "2026-09-08",
"lastSeen": "2026-11-03",
"credentials": [
{ "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
]
}
}
}
Una revalidación finalizada, donde ndocs describe a la persona que confirmaste:
{
"id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
"state": "PROCESS_STATE_FINISHED",
"data": {
"humanTokenMatch": "true",
"liveness": { "value": "live", "status": "validated" },
"ndocs": {
"distinctClientsCount": 2,
"transactionsCount": 4,
"firstSeen": "2026-09-08",
"lastSeen": "2026-11-04",
"credentials": [
{ "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
]
}
}
}
Un proceso fallido:
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
El token y el link del Journey solo se devuelven en la creación. Guárdalos de esa respuesta.
Errores
| Status | message | Significado |
|---|---|---|
| 404 | PROCESS_NOT_FOUND | El id no es un UUID o es desconocido |
| 502 | UPSTREAM_UNAVAILABLE | El proceso está pendiente y no se pudo verificar su resultado. Reintenta más tarde |
| 503 | DATABASE_UNAVAILABLE | Falló la base de datos. Reintenta más tarde |
Las lecturas se pueden reintentar con seguridad.