Skip to main content
POST
/
age-verify
curl -X POST \
  "https://verilock.io/api/v1/age-verify" \
  -H "Authorization: Bearer qi_live_your_api_key_here" \
  -F "file=@selfie.jpg" \
  -F "min_age=18"
{
  "verified": true,
  "estimated_age_low": 24,
  "estimated_age_high": 32,
  "min_age_required": 18,
  "confidence": 99.2
}
Verify a person’s age using facial analysis. Returns an estimated age range with confidence. No session required — standalone endpoint.

Parameters

file
file
required
Selfie image file. Accepted: jpg, jpeg, png. Max: 10 MB.
min_age
integer
required
Minimum required age (1–120). The person must appear at least this old to pass.
curl -X POST \
  "https://verilock.io/api/v1/age-verify" \
  -H "Authorization: Bearer qi_live_your_api_key_here" \
  -F "file=@selfie.jpg" \
  -F "min_age=18"
{
  "verified": true,
  "estimated_age_low": 24,
  "estimated_age_high": 32,
  "min_age_required": 18,
  "confidence": 99.2
}

Age in Sessions

When a selfie is uploaded to a KYC session, age estimation is extracted automatically. Results appear in the session selfie data:
{
  "selfies": [{
    "face_match_score": 96.45,
    "liveness_score": 88.30,
    "estimated_age_low": 32,
    "estimated_age_high": 38
  }]
}
If a min_age threshold is configured in your verification profile, sessions where the estimated maximum age is below the threshold are automatically declined.