---
title: Получение процесса
description: 'GET /v1/processes/{id} — чтение процесса и его результата: Human Token и аналитики по человеку.'
canonical: https://developer.unico.io/ru/human-plugin/api-reference/get-process
locale: ru
generated_by: markdown-export
---

# Получение процесса

Чтение процесса по id, который Human Plugin вернул при создании.

`GET /v1/processes/{id}`

`id` — это UUID из ответа на создание. Заголовка аутентификации и привязки к клиенту нет: любой вызывающий, который может обратиться к Human Plugin, может прочитать любой из его процессов.

```bash
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
```

## Когда приходит результат

- **Ожидающий** процесс (`PROCESS_STATE_CREATED`) проверяется при каждом чтении, и как только появляется результат, ответ содержит его.
- **Завершённый** или **неудавшийся** процесс окончателен, и ответ возвращается как есть.
- Прерванное создание отдаётся как неудавшееся примерно через 70 секунд после начала.

Чтение — единственный способ продвинуть ожидающий процесс: фонового задания нет, а возврат на ваш `callbackUri` не обновляет Human Plugin.

## Ответ

`200 OK` с той же структурой, что и при создании: `id`, `state` и `data`.

Ожидающий Journey:

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

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

### Завершённые и неудавшиеся процессы

Завершённый процесс возвращает результат в `data`: кто этот человек — в `humanToken`, и [аналитику](/ru/human-plugin/get-started/intelligence) по человеку — в `ndocs`, а также `liveness`, если поток её проверяет. Ревалидация вместо `humanToken` возвращает `humanTokenMatch`. Каждое поле описано в разделе [Результат в `data`](/ru/human-plugin/api-reference/create-process#result). Неудавшийся процесс возвращает `PROCESS_STATE_FAILED` с пустым `data`.

Завершённый процесс:

```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 }
      ]
    }
  }
}
```

Завершённая ревалидация, где `ndocs` описывает человека, которого вы подтвердили:

```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 }
      ]
    }
  }
}
```

Неудавшийся процесс:

```json
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
```

`token` и `link` Journey возвращаются только при создании. Сохраните их из того ответа.

## Ошибки

| Статус | `message` | Значение |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | Id не является UUID или неизвестен |
| 502 | `UPSTREAM_UNAVAILABLE` | Процесс ожидает, и его результат не удалось проверить. Повторите позже |
| 503 | `DATABASE_UNAVAILABLE` | Сбой базы данных. Повторите позже |

Чтение безопасно повторять.

## Далее

[Получение селфи](/ru/human-plugin/api-reference/get-selfie)