Age Estimation Check

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

Example request

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

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

Last updated