---
title: Obtener un proceso
description: GET /v1/processes/{id} — lee un proceso y su resultado, el Human Token y la inteligencia de la persona.
canonical: https://developer.unico.io/es/human-plugin/api-reference/get-process
locale: es
generated_by: markdown-export
---

# Obtener un proceso

Lee un proceso con el id que Human Plugin devolvió al crearlo.

`GET /v1/processes/{id}`

`id` es el UUID de la respuesta de creación. No hay encabezado de autenticación ni restricción por cliente: cualquier llamador que pueda alcanzar Human Plugin puede leer cualquiera de sus procesos.

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

## Cuándo llega el resultado

- Un proceso **pendiente** (`PROCESS_STATE_CREATED`) se verifica en cada lectura y se responde con su resultado en cuanto hay uno.
- Un proceso **finalizado** o **fallido** es definitivo y se responde tal cual.
- Una creación que fue interrumpida se responde como fallida unos 70 segundos después de haber comenzado.

La lectura es la única forma de que un proceso pendiente avance: no hay ningún job en segundo plano, y el retorno a tu `callbackUri` no actualiza Human Plugin.

## Respuesta

`200 OK` con la misma estructura que una creación: `id`, `state` y `data`.

Un Journey pendiente:

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

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

### Procesos finalizados y fallidos

Un proceso finalizado devuelve su resultado en `data`: quién es la persona, en `humanToken`, y la [inteligencia](/es/human-plugin/get-started/intelligence) de la persona, en `ndocs`, además de `liveness` cuando el flujo lo verifica. Una revalidación devuelve `humanTokenMatch` en lugar de `humanToken`. Cada campo se describe en [El resultado en `data`](/es/human-plugin/api-reference/create-process#result). Un proceso fallido devuelve `PROCESS_STATE_FAILED` con un `data` vacío.

Un proceso finalizado:

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

Una revalidación finalizada, donde `ndocs` describe a la persona que confirmaste:

```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 proceso fallido:

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

El `token` y el `link` del Journey solo se devuelven en la creación. Guárdalos de esa respuesta.

## Errores

| Status | `message` | Significado |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | El id no es un UUID o es desconocido |
| 502 | `UPSTREAM_UNAVAILABLE` | El proceso está pendiente y no se pudo verificar su resultado. Reintenta más tarde |
| 503 | `DATABASE_UNAVAILABLE` | Falló la base de datos. Reintenta más tarde |

Las lecturas se pueden reintentar con seguridad.

## Siguiente

[Obtener la selfie](/es/human-plugin/api-reference/get-selfie)