---
title: Einen Prozess abrufen
description: GET /v1/processes/{id} — einen Prozess und sein Ergebnis abrufen, den Human Token und die Intelligence zur Person.
canonical: https://developer.unico.io/de/human-plugin/api-reference/get-process
locale: de
generated_by: markdown-export
---

# Einen Prozess abrufen

Rufen Sie einen Prozess über die id ab, die Human Plugin beim Erstellen zurückgegeben hat.

`GET /v1/processes/{id}`

`id` ist die UUID aus der Antwort auf das Erstellen. Es gibt keinen Authentifizierungs-Header und keine Mandantentrennung: Jeder Aufrufer, der Human Plugin erreichen kann, kann jeden seiner Prozesse lesen.

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

## Wann das Ergebnis vorliegt

- Ein **ausstehender** Prozess (`PROCESS_STATE_CREATED`) wird bei jedem Lesen geprüft und mit seinem Ergebnis beantwortet, sobald eines vorliegt.
- Ein **abgeschlossener** oder **fehlgeschlagener** Prozess ist endgültig und wird unverändert beantwortet.
- Ein unterbrochenes Erstellen wird etwa 70 Sekunden nach seinem Start als fehlgeschlagen beantwortet.

Das Lesen ist die einzige Möglichkeit, einen ausstehenden Prozess voranzubringen: Es gibt keinen Hintergrundjob, und die Rückkehr zu Ihrer `callbackUri` aktualisiert Human Plugin nicht.

## Antwort

`200 OK` mit derselben Struktur wie beim Erstellen: `id`, `state` und `data`.

Eine ausstehende Journey:

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

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

### Abgeschlossene und fehlgeschlagene Prozesse

Ein abgeschlossener Prozess liefert sein Ergebnis in `data`: wer die Person ist, in `humanToken`, und die [Intelligence](/de/human-plugin/get-started/intelligence) zur Person, in `ndocs`, sowie `liveness`, wenn der Flow sie prüft. Eine Revalidierung liefert `humanTokenMatch` anstelle von `humanToken`. Jedes Feld ist unter [Das Ergebnis in `data`](/de/human-plugin/api-reference/create-process#result) beschrieben. Ein fehlgeschlagener Prozess liefert `PROCESS_STATE_FAILED` mit leerem `data`.

Ein abgeschlossener Prozess:

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

Eine abgeschlossene Revalidierung, bei der `ndocs` die von Ihnen bestätigte Person beschreibt:

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

Ein fehlgeschlagener Prozess:

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

Das Journey-`token` und der `link` werden nur beim Erstellen zurückgegeben. Bewahren Sie sie aus dieser Antwort auf.

## Fehler

| Status | `message` | Bedeutung |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | Die id ist keine UUID oder unbekannt |
| 502 | `UPSTREAM_UNAVAILABLE` | Der Prozess ist ausstehend und sein Ergebnis konnte nicht geprüft werden. Später erneut versuchen |
| 503 | `DATABASE_UNAVAILABLE` | Die Datenbank ist ausgefallen. Später erneut versuchen |

Lesezugriffe können gefahrlos wiederholt werden.

## Weiter

[Das Selfie abrufen](/de/human-plugin/api-reference/get-selfie)