> ## 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.

# Obtener verificación Face Match

> Obtener un registro de auditoría de Face Match por ID — en la API KYC de gu1 para flujos de verificación de identidad, con ejemplos para get face match.

## Resumen

Devuelve una verificación de Face Match por su `id` (el mismo UUID que se devuelve como `verificationId` en la respuesta del [POST Face Match](/es/use-cases/kyc/face-match) o en el endpoint de listado). Úsalo para consultar el detalle de una verificación pasada (auditoría, soporte o vistas de detalle).

**Puntos clave:**

* Scoped a tu organización; devuelve 404 si el ID no existe o pertenece a otra organización.
* Mismos campos que cada ítem del listado: `id`, `entityId`, `status`, `match`, `score`, `threshold`, `createdAt` y rutas de imágenes opcionales.

<Info>
  Para descargar los bytes del **documento** y del **selfie** almacenados, usá [Obtener imágenes Face Match](/es/use-cases/kyc/face-match-images) (`/document-image` y `/selfie-image`).
</Info>

## Solicitud

### Endpoint

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

### Parámetros de path

<ParamField path="id" type="string" required>
  UUID de la verificación Face Match (el mismo que <code>verificationId</code> del POST o del listado).
</ParamField>

### Headers

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

Incluye `X-Organization-Id` si tu cuenta está scoped por organización.

## Respuesta

### Éxito (200 OK)

Objeto único de verificación:

| Campo                 | Tipo           | Descripción                                                                            |
| --------------------- | -------------- | -------------------------------------------------------------------------------------- |
| `id`                  | string         | UUID de la verificación.                                                               |
| `organizationId`      | string         | Organización que posee el registro.                                                    |
| `entityId`            | string \| null | ID de la entidad persona si se envió en la solicitud.                                  |
| `status`              | string         | `approved` \| `declined` \| `in_review` \| `failed`.                                   |
| `match`               | boolean        | Si las caras se consideraron coincidentes.                                             |
| `score`               | number \| null | Puntaje de similitud 0–100 (null cuando `status` es `failed`).                         |
| `requestId`           | string \| null | ID interno de la solicitud (soporte).                                                  |
| `vendorData`          | string \| null | Referencia del cliente en la solicitud.                                                |
| `errorMessage`        | string \| null | Mensaje de error cuando `status` es `failed`.                                          |
| `triggeredByUserId`   | string \| null | Usuario que llamó a la API.                                                            |
| `createdAt`           | string         | Timestamp ISO.                                                                         |
| `documentStoragePath` | string \| null | Ruta de almacenamiento de la imagen del documento (auditoría).                         |
| `selfieStoragePath`   | string \| null | Ruta de almacenamiento de la selfie (auditoría).                                       |
| `storageProvider`     | string \| null | `s3` o `local`.                                                                        |
| `threshold`           | number \| null | Umbral de puntaje usado en esta verificación (configuración de la org en ese momento). |

### Respuestas de error

| Código         | HTTP | Descripción                                                      |
| -------------- | ---- | ---------------------------------------------------------------- |
| `NOT_FOUND`    | 404  | El ID de verificación no existe o pertenece a otra organización. |
| `UNAUTHORIZED` | 401  | API key o contexto de organización ausente o inválido.           |

## Ejemplo

<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 pasos

<CardGroup cols={2}>
  <Card title="Face Match (POST)" icon="play" href="/es/use-cases/kyc/face-match">
    Verificar documento + selfie en una llamada
  </Card>

  <Card title="Listar validaciones" icon="list" href="/es/use-cases/kyc/list-validations">
    Listar validaciones KYC por entidad
  </Card>
</CardGroup>