---
title: 프로세스 조회
description: GET /v1/processes/{id} — 프로세스와 그 결과, Human Token, 그리고 해당 인물의 인텔리전스를 조회합니다.
canonical: https://developer.unico.io/ko/human-plugin/api-reference/get-process
locale: ko
generated_by: markdown-export
---

# 프로세스 조회

생성 시 Human Plugin이 반환한 id로 프로세스를 조회합니다.

`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이 갱신되지 않습니다.

## 응답

생성과 동일한 형태(`id`, `state`, `data`)의 `200 OK`를 반환합니다.

대기 중인 Journey:

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

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

### 완료된 프로세스와 실패한 프로세스

완료된 프로세스는 `data`에 결과를 담아 반환합니다. `humanToken`에는 해당 인물이 누구인지, `ndocs`에는 해당 인물의 [인텔리전스](/ko/human-plugin/get-started/intelligence)가 담기며, 플로우가 라이브니스를 확인하는 경우 `liveness`도 함께 반환됩니다. 재검증은 `humanToken` 대신 `humanTokenMatch`를 반환합니다. 각 필드는 [`data`의 결과](/ko/human-plugin/api-reference/create-process#result)에 설명되어 있습니다. 실패한 프로세스는 빈 `data`와 함께 `PROCESS_STATE_FAILED`를 반환합니다.

완료된 프로세스:

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

Journey의 `token`과 `link`는 생성 응답에서만 반환됩니다. 해당 응답에서 보관해 두세요.

## 오류

| Status | `message` | 의미 |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | id가 UUID가 아니거나 알 수 없는 id입니다 |
| 502 | `UPSTREAM_UNAVAILABLE` | 프로세스가 대기 중이며 결과를 확인하지 못했습니다. 나중에 다시 시도하세요 |
| 503 | `DATABASE_UNAVAILABLE` | 데이터베이스에 장애가 발생했습니다. 나중에 다시 시도하세요 |

조회는 재시도해도 안전합니다.

## 다음

[셀피 조회](/ko/human-plugin/api-reference/get-selfie)