> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter verificação Face Match

> Recuperar um registro de auditoria de Face Match por ID — na API KYC da gu1 para fluxos de verificação de identidade, com exemplos para get face match.

## Resumo

Retorna uma verificação de Face Match pelo seu `id` (o mesmo UUID retornado como `verificationId` na resposta do [POST Face Match](/pt/use-cases/kyc/face-match) ou no endpoint de listagem). Use para consultar o detalhe de uma verificação passada (auditoria, suporte ou telas de detalhe).

**Pontos principais:**

* Scoped à sua organização; retorna 404 se o ID não existir ou pertencer a outra organização.
* Mesmos campos de cada item da listagem: `id`, `entityId`, `status`, `match`, `score`, `threshold`, `createdAt` e caminhos de imagens opcionais.

<Info>
  Para baixar os bytes do **documento** e do **selfie** armazenados, use [Obter imagens Face Match](/pt/use-cases/kyc/face-match-images) (`/document-image` e `/selfie-image`).
</Info>

## Solicitação

### Endpoint

```
GET https://api.gu1.ai/api/kyc/face-match/verifications/:id
```

### Parâmetros de path

<ParamField path="id" type="string" required>
  UUID da verificação Face Match (o mesmo que <code>verificationId</code> do POST ou da listagem).
</ParamField>

### Headers

```json theme={null}
{
  "Authorization": "Bearer YOUR_API_KEY"
}
```

Inclua `X-Organization-Id` se sua conta for scoped por organização.

## Resposta

### Sucesso (200 OK)

Objeto único de verificação:

| Campo                 | Tipo           | Descrição                                                                          |
| --------------------- | -------------- | ---------------------------------------------------------------------------------- |
| `id`                  | string         | UUID da verificação.                                                               |
| `organizationId`      | string         | Organização que possui o registro.                                                 |
| `entityId`            | string \| null | ID da entidade pessoa se enviado na solicitação.                                   |
| `status`              | string         | `approved` \| `declined` \| `in_review` \| `failed`.                               |
| `match`               | boolean        | Se as faces foram consideradas coincidentes.                                       |
| `score`               | number \| null | Pontuação de similaridade 0–100 (null quando `status` é `failed`).                 |
| `requestId`           | string \| null | ID interno da solicitação (suporte).                                               |
| `vendorData`          | string \| null | Referência do cliente na solicitação.                                              |
| `errorMessage`        | string \| null | Mensagem de erro quando `status` é `failed`.                                       |
| `triggeredByUserId`   | string \| null | Usuário que chamou a API.                                                          |
| `createdAt`           | string         | Timestamp ISO.                                                                     |
| `documentStoragePath` | string \| null | Caminho de armazenamento da imagem do documento (auditoria).                       |
| `selfieStoragePath`   | string \| null | Caminho de armazenamento da selfie (auditoria).                                    |
| `storageProvider`     | string \| null | `s3` ou `local`.                                                                   |
| `threshold`           | number \| null | Limiar de pontuação usado nesta verificação (configuração da org naquele momento). |

### Respostas de erro

| Código         | HTTP | Descrição                                                       |
| -------------- | ---- | --------------------------------------------------------------- |
| `NOT_FOUND`    | 404  | O ID da verificação não existe ou pertence a outra organização. |
| `UNAUTHORIZED` | 401  | API key ou contexto de organização ausente ou inválido.         |

## Exemplo

<CodeGroup>
  ```javascript Node.js theme={null}
  const id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
  const response = await fetch(`https://api.gu1.ai/api/kyc/face-match/verifications/${id}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  });
  const verification = await response.json();
  ```

  ```curl cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://api.gu1.ai/api/kyc/face-match/verifications/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ```
</CodeGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Face Match (POST)" icon="play" href="/pt/use-cases/kyc/face-match">
    Verificar documento + selfie em uma chamada
  </Card>

  <Card title="Listar validações" icon="list" href="/pt/use-cases/kyc/list-validations">
    Listar validações KYC por entidade
  </Card>
</CardGroup>