---
title: Consultar um processo
description: GET /v1/processes/{id} — consulta um processo e seu resultado, o Human Token e a inteligência da pessoa.
canonical: https://developer.unico.io/pt-BR/human-plugin/api-reference/get-process
locale: pt-BR
generated_by: markdown-export
---

# Consultar um processo

Consulte um processo pelo id que o Human Plugin retornou na criação.

`GET /v1/processes/{id}`

`id` é o UUID da resposta de criação. Não há header de autenticação nem escopo por cliente: qualquer chamador que consiga alcançar o Human Plugin pode consultar qualquer um dos seus processos.

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

## Quando o resultado chega

- Um processo **pendente** (`PROCESS_STATE_CREATED`) é verificado a cada consulta e respondido com o resultado assim que houver um.
- Um processo **finalizado** ou **com falha** é definitivo e é respondido como está.
- Uma criação que foi interrompida é respondida como falha cerca de 70 segundos depois de iniciada.

A consulta é a única forma de um processo pendente avançar: não há job em segundo plano, e o retorno ao seu `callbackUri` não atualiza o Human Plugin.

## Resposta

`200 OK` com o mesmo formato de uma criação: `id`, `state` e `data`.

Uma Journey pendente:

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

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

### Processos finalizados e com falha

Um processo finalizado retorna o resultado em `data`: quem é a pessoa, em `humanToken`, e a [inteligência](/pt-BR/human-plugin/get-started/intelligence) da pessoa, em `ndocs`, além de `liveness` quando o fluxo a verifica. Uma revalidação retorna `humanTokenMatch` no lugar de `humanToken`. Cada campo é descrito em [O resultado em `data`](/pt-BR/human-plugin/api-reference/create-process#result). Um processo com falha retorna `PROCESS_STATE_FAILED` com `data` vazio.

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

Uma revalidação finalizada, em que `ndocs` descreve a pessoa que você confirmou:

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

Um processo com falha:

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

O `token` e o `link` da Journey são retornados somente pela criação. Guarde-os a partir dessa resposta.

## Erros

| Status | `message` | Significado |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | O id não é um UUID ou é desconhecido |
| 502 | `UPSTREAM_UNAVAILABLE` | O processo está pendente e não foi possível verificar seu resultado. Tente novamente mais tarde |
| 503 | `DATABASE_UNAVAILABLE` | O banco de dados falhou. Tente novamente mais tarde |

As consultas podem ser repetidas com segurança.

## Próximo passo

[Consultar a selfie](/pt-BR/human-plugin/api-reference/get-selfie)