# Face Authentication Check

### What kind of data I will get

The Face Authentication Check service provided by ComplyCube allows businesses to authenticate the identity of their users through advanced facial recognition technology. This service is designed to improve security and streamline the authentication process by matching a person's face against previously registered biometric data. 

To utilize the Face Authentication Check, the customer must have successfully passed a check that required providing photo of the person.

One key advantage of the Face Authentication Check is that it does not require the customer to provide their ID again. The system utilizes the image captured during the initial Identity Check for comparison purposes.

### Input

<table><thead><tr><th width="156">Field</th><th>Description</th><th>Type</th><th>Required</th><th data-hidden>Description</th><th data-hidden>Required</th></tr></thead><tbody><tr><td>clientId</td><td>Id of the client that successfully passed other identity confirming check</td><td>string</td><td>Yes</td><td>Email address of the client.</td><td>Yes</td></tr></tbody></table>

### Input Example

```
{
    "clientId": "6230d4ab58ed4a434afbf2cc"
}
```

### Output&#x20;

| Attribute               | Type   | Description                                               |
| ----------------------- | ------ | --------------------------------------------------------- |
| id                      | String | Unique identifier for the main entity                     |
| entityName              | String | Name of the entity being processed                        |
| type                    | String | Type of the operation (e.g., face\_authentication\_check) |
| clientId                | String | Unique identifier for the client                          |
| livePhotoId             | String | Identifier for the live photo used in the authentication  |
| status                  | String | Current status of the process (e.g., complete)            |
| [result](#result-table) | Object | Object containing detailed result data                    |
| updatedAt               | String | Timestamp of the last update                              |
| createdAt               | String | Timestamp of when the entity was created                  |

### Result

| Attribute               | Type   | Description                                          |
| ----------------------- | ------ | ---------------------------------------------------- |
| outcome                 | String | Final outcome of the authentication (e.g., clear)    |
| [breakdown](#breakdown) | Object | Object containing a detailed breakdown of the result |

### Breakdown

| Attribute                                 | Type   | Description                                                      |
| ----------------------------------------- | ------ | ---------------------------------------------------------------- |
| [faceAuthentication](#faceauthentication) | Object | Object containing face authentication and similarity information |

### FaceAuthentication

| Attribute                  | Type   | Description                                       |
| -------------------------- | ------ | ------------------------------------------------- |
| facialSimilarity           | String | Similarity status of the face (e.g., clear)       |
| [breakdown](#subbreakdown) | Object | Object containing detailed information on matches |

### SubBreakdown

| Attribute                       | Type           | Description                                        |
| ------------------------------- | -------------- | -------------------------------------------------- |
| [facesMatched](#facematch)      | Array\<Object> | List of objects containing facial match info       |
| [enrolledFaces](#enrolledfaces) | Object         | Object containing information about enrolled faces |

### FaceMatch

| Attribute             | Type    | Description                                       |
| --------------------- | ------- | ------------------------------------------------- |
| livePhotoId           | String  | Identifier for the matched live photo             |
| facialSimilarityScore | Integer | Score indicating the similarity of the face match |

### EnrolledFaces

| Attribute    | Type           | Description                                |
| ------------ | -------------- | ------------------------------------------ |
| livePhotoIds | Array\<String> | List of identifiers for the enrolled faces |

### Output Example

```
{
    "id": "6231d54079f59b1530fc76e3",
    "entityName": "John Doe",
    "type": "face_authentication_check",
    "clientId": "6230d4ab58ed4a434afbf2cc",
    "livePhotoId": "6231d137095afa000955ffc2",
    "status": "complete",
    "result": {
        "outcome": "clear",
        "breakdown": {
            "faceAuthentication": {
                "facialSimilarity": "clear",
                "breakdown": {
                    "facesMatched": [
                        {
                            "livePhotoId": "6230d4f928e6ae00091747f9",
                            "facialSimilarityScore": 100
                        }
                    ],
                    "enrolledFaces": {
                        "livePhotoIds": [
                            "6230d4f928e6ae00091747f9",
                            "6230d4f928e6ae00091747fa"
                        ]
                    }
                }
            }
        }
    },
    "updatedAt": "2022-03-01T12:17:06.046Z",
    "createdAt": "2022-03-01T12:17:04.809Z"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.transactionlink.io/docs/v1/integrations/complycube/face-authentication-check.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.