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

# Get Face Match Verification

> Retrieve a single Face Match audit record by ID — in the gu1 KYC API for identity verification flows, with examples for get face match verification use cases.

## Overview

Returns one Face Match verification by its `id` (the same UUID returned as `verificationId` in the [POST Face Match](/en/use-cases/kyc/face-match) response or in the list endpoint). Use it to fetch full details of a past verification for audit, support, or detail views.

**Key points:**

* Scoped to your organization; returns 404 if the ID does not exist or belongs to another org.
* Same fields as each item in the list: `id`, `entityId`, `status`, `match`, `score`, `threshold`, `createdAt`, and optional image paths.

<Info>
  To download stored **document** and **selfie** bytes, use [Get Face Match images](/en/use-cases/kyc/face-match-images) (`/document-image` and `/selfie-image`).
</Info>

## Request

### Endpoint

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

### Path Parameters

<ParamField path="id" type="string" required>
  UUID of the Face Match verification (same as <code>verificationId</code> from POST or list).
</ParamField>

### Headers

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

Include `X-Organization-Id` if your account is scoped by organization.

## Response

### Success (200 OK)

Single verification object:

| Field                 | Type           | Description                                                                 |
| --------------------- | -------------- | --------------------------------------------------------------------------- |
| `id`                  | string         | Verification UUID.                                                          |
| `organizationId`      | string         | Organization that owns the record.                                          |
| `entityId`            | string \| null | Person entity ID if provided in the request.                                |
| `status`              | string         | `approved` \| `declined` \| `in_review` \| `failed`.                        |
| `match`               | boolean        | Whether faces were considered a match.                                      |
| `score`               | number \| null | Similarity score 0–100 (null when `status` is `failed`).                    |
| `requestId`           | string \| null | Internal request ID (support).                                              |
| `vendorData`          | string \| null | Client reference from the request.                                          |
| `errorMessage`        | string \| null | Error message when `status` is `failed`.                                    |
| `triggeredByUserId`   | string \| null | User who called the API.                                                    |
| `createdAt`           | string         | ISO timestamp.                                                              |
| `documentStoragePath` | string \| null | Storage path for document image (audit).                                    |
| `selfieStoragePath`   | string \| null | Storage path for selfie image (audit).                                      |
| `storageProvider`     | string \| null | `s3` or `local`.                                                            |
| `threshold`           | number \| null | Score threshold used for this verification (from org settings at the time). |

### Error Responses

| Code           | HTTP | Description                                                        |
| -------------- | ---- | ------------------------------------------------------------------ |
| `NOT_FOUND`    | 404  | Verification ID does not exist or belongs to another organization. |
| `UNAUTHORIZED` | 401  | Missing or invalid API key or organization context.                |

## Example

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

## Next Steps

<CardGroup cols={2}>
  <Card title="Face Match (POST)" icon="play" href="/en/use-cases/kyc/face-match">
    Verify document + selfie in one call
  </Card>

  <Card title="List Validations" icon="list" href="/en/use-cases/kyc/list-validations">
    List KYC validations by entity
  </Card>
</CardGroup>