---
title: Consultar a selfie
description: GET /v1/processes/{id}/selfie — consulta a selfie capturada para um processo, por quanto tempo ela fica disponível e os erros.
canonical: https://developer.unico.io/pt-BR/human-plugin/api-reference/get-selfie
locale: pt-BR
generated_by: markdown-export
---

# Consultar a selfie

Consulte a selfie capturada para um processo, pelo id que o Human Plugin retornou na criação.

`GET /v1/processes/{id}/selfie`

`id` é o UUID da resposta de criação. A requisição não tem corpo nem parâmetros de query.

```bash
curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie
```

O Human Plugin não guarda uma cópia da selfie: cada chamada a busca novamente.

## Resposta

`200 OK`, com a imagem em base64 e seu tipo:

```json
{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}
```

Para salvá-la como arquivo:

```bash
curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg
```

## Disponibilidade

- Só há selfie para um processo que teve uma: enviada em `imageBase64` ou capturada da pessoa.
- Em um fluxo Journey, a selfie só existe depois que a pessoa a captura. Até lá, a requisição é recusada com `400` e uma `message` que começa com `process state must be finished`. [Consulte o processo](/pt-BR/human-plugin/api-reference/get-process) primeiro e busque a selfie quando ele estiver em `PROCESS_STATE_FINISHED`.
- A selfie fica disponível por um tempo limitado depois que o processo termina. Se precisar dela mais tarde, armazene-a a partir desta resposta.

## Como tratar a imagem

A selfie é um dado biométrico. O Human Plugin nunca a armazena nem a registra em logs, e a resposta é enviada com `Cache-Control: no-store`. Mantenha-a fora dos logs do seu gateway e da sua aplicação também.

## Erros

| Status | `message` | Significado |
| --- | --- | --- |
| 400 | `process state must be finished…` | Um processo Journey cuja captura ainda não terminou. Consulte o processo primeiro |
| 404 | `PROCESS_NOT_FOUND` | O id não é um UUID ou é desconhecido |
| 404 | `SELFIE_NOT_FOUND` | O processo não tem selfie: não houve captura, ele falhou antes de começar ou a selfie não está mais disponível |
| 4xx | A `message` da recusa | A requisição foi recusada. O motivo está em `message` e `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | Não foi possível buscar a selfie a tempo. Tente novamente mais tarde |
| 503 | `DATABASE_UNAVAILABLE` | O banco de dados falhou. Tente novamente mais tarde |

As consultas podem ser repetidas com segurança. Um `404` não muda ao tentar de novo.

## Próximo passo

[Ciclo de vida do processo](/pt-BR/human-plugin/api-reference/process-lifecycle)