Lisez un processus avec l'id que Human Plugin a renvoyé à la création.
GET /v1/processes/{id}
id est l'UUID de la réponse de création. Il n'y a ni en-tête d'authentification ni restriction par client : tout appelant qui peut joindre Human Plugin peut lire n'importe lequel de ses processus.
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
Quand le résultat arrive
- Un processus en attente (
PROCESS_STATE_CREATED) est vérifié à chaque lecture, et reçoit son résultat dès qu'il y en a un. - Un processus terminé ou échoué est définitif, et est renvoyé tel quel.
- Une création interrompue est renvoyée comme échouée environ 70 secondes après son démarrage.
La lecture est le seul moyen de faire avancer un processus en attente : il n'y a pas de tâche en arrière-plan, et le retour vers votre callbackUri ne met pas Human Plugin à jour.
Réponse
200 OK avec la même structure qu'une création : id, state et data.
Un Journey en attente :
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
Processus terminés et échoués
Un processus terminé renvoie son résultat dans data : qui est la personne, dans humanToken, et l'intelligence de la personne, dans ndocs, plus liveness lorsque le flux la vérifie. Une revalidation renvoie humanTokenMatch à la place de humanToken. Chaque champ est décrit dans Le résultat dans data. Un processus échoué renvoie PROCESS_STATE_FAILED avec un data vide.
Un processus terminé :
{
"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 }
]
}
}
}
Une revalidation terminée, où ndocs décrit la personne que vous avez confirmée :
{
"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 processus échoué :
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
Le token et le link du Journey ne sont renvoyés que par la création. Conservez-les depuis cette réponse.
Erreurs
| Statut | message | Signification |
|---|---|---|
| 404 | PROCESS_NOT_FOUND | L'id n'est pas un UUID ou est inconnu |
| 502 | UPSTREAM_UNAVAILABLE | Le processus est en attente et son résultat n'a pas pu être vérifié. Réessayez plus tard |
| 503 | DATABASE_UNAVAILABLE | La base de données a échoué. Réessayez plus tard |
Les lectures peuvent être réessayées sans risque.