---
title: Ambil proses
description: GET /v1/processes/{id} — membaca proses beserta hasilnya, Human Token, dan intelijen tentang orang tersebut.
canonical: https://developer.unico.io/id/human-plugin/api-reference/get-process
locale: id
generated_by: markdown-export
---

# Ambil proses

Baca proses berdasarkan id yang dikembalikan Human Plugin saat pembuatan.

`GET /v1/processes/{id}`

`id` adalah UUID dari respons pembuatan. Tidak ada header autentikasi dan tidak ada pembatasan per klien: pemanggil mana pun yang dapat menjangkau Human Plugin dapat membaca proses apa pun miliknya.

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

## Kapan hasil tersedia

- Proses yang **tertunda** (`PROCESS_STATE_CREATED`) diperiksa pada setiap pembacaan, dan dijawab dengan hasilnya begitu hasil tersedia.
- Proses yang **selesai** atau **gagal** bersifat final, dan dijawab apa adanya.
- Pembuatan yang terputus dijawab sebagai gagal sekitar 70 detik setelah dimulai.

Pembacaan adalah satu-satunya cara proses yang tertunda dapat maju: tidak ada tugas latar belakang, dan kembalinya orang tersebut ke `callbackUri` Anda tidak memperbarui Human Plugin.

## Respons

`200 OK` dengan bentuk yang sama seperti respons pembuatan: `id`, `state`, dan `data`.

Journey yang tertunda:

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

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

### Proses yang selesai dan yang gagal

Proses yang selesai mengembalikan hasilnya di `data`: siapa orang tersebut, di `humanToken`, dan [intelijen](/id/human-plugin/get-started/intelligence) tentang orang itu, di `ndocs`, ditambah `liveness` jika alur memeriksanya. Revalidasi mengembalikan `humanTokenMatch` sebagai ganti `humanToken`. Setiap field dijelaskan di [Hasil di `data`](/id/human-plugin/api-reference/create-process#result). Proses yang gagal mengembalikan `PROCESS_STATE_FAILED` dengan `data` kosong.

Proses yang selesai:

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

Revalidasi yang selesai, di mana `ndocs` menggambarkan orang yang Anda konfirmasi:

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

Proses yang gagal:

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

`token` dan `link` Journey hanya dikembalikan oleh pembuatan. Simpan keduanya dari respons tersebut.

## Error

| Status | `message` | Arti |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | Id bukan UUID atau tidak dikenal |
| 502 | `UPSTREAM_UNAVAILABLE` | Proses tertunda dan hasilnya tidak dapat diperiksa. Coba lagi nanti |
| 503 | `DATABASE_UNAVAILABLE` | Database gagal. Coba lagi nanti |

Pembacaan aman untuk dicoba ulang.

## Selanjutnya

[Ambil selfie](/id/human-plugin/api-reference/get-selfie)