Age Estimation Check

Age Estimation Check API for KYC age assurance, biometric age estimation, facial analysis, and age-based access controls.

Run an age estimation check

To run an Age Estimation Check, you must create a check with type set to age_estimation_check.

This check can only be performed on a client of type person.

Learn more about Age Estimation Checks.

Get in touch with your Account Manager or contact us to enable this service.

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

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": "age_estimation_check"
        }'

Node.js

const check = await complycube.check.create("CLIENT_ID", {
        livePhotoId: "LIVE_PHOTO_ID",
        type: "age_estimation_check"
});

Python

check = cc_api.check.create(
    'CLIENT_ID',
    'age_estimation_check',
    livePhotoId='LIVE_PHOTO_ID'
)

PHP

$result = $ccapi->checks()->create('CLIENT_ID',
                                   ['type' => 'age_estimation_check',
                                   'livePhotoId' => 'LIVE_PHOTO_ID']);

.NET

var checkRequest = new CheckRequest {
  clientId = "CLIENT_ID",
  livePhotoId = "LIVE_PHOTO_ID",
  type = "age_estimation_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 every analysis conducted returned a successful result, and hence the age estimation check is successful.
2. attention: Indicates at least one of the analysis results requires attention.

Breakdown

The breakdown comprises the following objects:

ageEstimationAnalysis object

The age estimation analysis results. It has the following constituents:

• ageValidation: Indicates whether the estimated age is greater than or equal to a predefined minimum accepted age.
• breakdown: Breakdown related to age estimation analysis.

  • age: Indicates the estimated age of the person in the live photo. The age will be in years.
  • ageMin: Indicates the minimum estimated age of the person in the live photo. The age will be in years.
  • ageMax: Indicates the maximum estimated age of the person in the live photo. The age will be in years.

authenticityAnalysis object

The facial analysis results. It has the following constituents:

• livenessCheck: Indicates if the live photo is genuine and not a photo-of-an-image or photo-of-a-screen.
• breakdown: Breakdown related to authenticity analysis.

  • livenessCheckScore: Indicates the liveness score of the live photo. The score will be 100 when it is assumed to be authentic.

Sample Response

{
  "id": "6231d54079f59b1530fc76e3",
  "entityName": "John Doe",
  "type": "age_estimation_check",
  "clientId": "6230d4ab58ed4a434afbf2cc",
  "livePhotoId": "6231d137095afa000955ffc2",
  "status": "complete",
  "result": {
    "outcome": "clear",
    "breakdown": {
      "ageEstimationAnalysis": {
        "ageValidation": "clear",
        "breakdown": {
          "age": 33,
          "ageMin": 27,
          "ageMax": 38
        }
      },
      "authenticityAnalysis": {
        "livenessCheck": "clear",
        "breakdown": {
          "livenessCheckScore": 100
        }
      }
    }
  },
  "updatedAt": "2022-03-01T12:17:06.046Z",
  "createdAt": "2022-03-01T12:17:04.809Z"
}