---
title: Obtenir un processus
description: GET /v1/processes/{id} — lire un processus et son résultat, le Human Token et l'intelligence de la personne.
canonical: https://developer.unico.io/fr/human-plugin/api-reference/get-process
locale: fr
generated_by: markdown-export
---

# Obtenir un processus

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.

```bash
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 :

```json
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
```

<a id="finished-and-failed-processes"></a>

### Processus terminés et échoués

Un processus terminé renvoie son résultat dans `data` : qui est la personne, dans `humanToken`, et l'[intelligence](/fr/human-plugin/get-started/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`](/fr/human-plugin/api-reference/create-process#result). Un processus échoué renvoie `PROCESS_STATE_FAILED` avec un `data` vide.

Un processus terminé :

```json
{
  "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 :

```json
{
  "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é :

```json
{ "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.

## Suite

[Obtenir le selfie](/fr/human-plugin/api-reference/get-selfie)