Face Authentication Check

Search…
Run a face authentication check
To run a Face Authentication Check, you must create a check with type set to face_authentication_check.
This check can only be performed on a client of type person. Furthermore, the provided client must have been enrolled previously.
​Learn more about Face Authentication Checks.
Get in touch with your Account Manager or contact us to enable this service.
Face authentication check request
Attribute
Type
Description
clientId
string
The ID of the client associated with this check. (Required)
livePhotoId
string
The ID of the live photo. (Required)
Example request
cURL
Node.js
Python
PHP
.NET
curl -X POST https://api.complycube.com/v1/checks \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          "clientId":"CLIENT_ID",
          "livePhotoId":"LIVE_PHOTO_ID",
          "type": "face_authentication_check"
        }'
const check = await complycube.check.create("CLIENT_ID", {
        livePhotoId: "LIVE_PHOTO_ID",
        type: "face_authentication_check"
});
check = cc_api.check.create('CLIENT_ID', 
                                'face_authentication_check', 
                                livePhotoId='LIVE_PHOTO_ID')
$result = $ccapi->checks()->create('CLIENT_ID',
                                   ['type' => 'face_authentication_check',
                                   'livePhotoId' => 'LIVE_PHOTO_ID']);
var checkRequest = new CheckRequest
                    {
                        clientId = "CLIENT_ID",
                        livePhotoId = "LIVE_PHOTO_ID",
                        type = "face_authentication_check"
                    };
​
var check = await checkApi.CreateAsync(checkRequest);
Result object
The result object is only returned when the status of the check is complete . It has two components - outcome and breakdown.
Outcome
The outcome attribute represents the overall check result. Returned values include:
1.clear: Indicates the face on the provided live photo matches one of the client's previously enrolled faces, and hence the client's face authentication is successful.
2.attention: Indicates the face on the live photo does not match any of the client's previously enrolled faces, hence requiring attention.
Breakdown
The breakdown comprises the following objects:
faceAuthentication object
The face authentication results. It has the following constituents:
facialSimilarity: Indicates whether the face on the live photo matches a client's enrolled face.
breakdown: Breakdown related to face authentication.
facesMatched: If the live photo matches an enrolled face, this attribute will be returned. It contains the following:
livePhotoId: The ID of the live photo corresponding to the enrolled face that matched. 
liveVideoId: The ID of the live video corresponding to the enrolled face that matched.
facialSimilarityScore: Indicates the similarity level of the face on the live photo provided against the enrolled face. The score will be 100 for a perfect match.
enrolledFaces: This contains details about previously enrolled faces for a given client. It comprises of the following: 
livePhotoIds: An array of live photo IDs used for enrolling the client's face.
liveVideoIds: An array of live video IDs used for enrolling the client's face.
Sample Response
{
    "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"
}
Check types - Previous
Multi-Bureau Check
Next - Lookups
Company Search
Last modified 6mo ago
Copy link
Outline
Run a face authentication check
Face authentication check request
Example request
Result object
Outcome
Breakdown
Sample Response