Skip to main content
POST
Estimate Age
Submit a single image containing a face. The response returns an age range, a single integer estimate within the range, and a gender estimate with confidence. Use this when you need to gate an experience by approximate age — for example, age-restricted product access — without requiring a full ID scan.

Request

Headers

Body parameters

See the overview for the shared image rules.

Example request

Response

200 — Success

Error responses

Interpreting the range

The returned range is broad by design — Rekognition estimates an age band, not a single value. A common pattern is:
  • If ageRange.low >= your_minimum_age, accept immediately.
  • If ageRange.high < your_minimum_age, reject immediately.
  • Otherwise the user falls in the ambiguous band — fall back to a full ID-based verification via /v1/document/scan or /v1/identity/verify.
Age estimation is probabilistic and should not be used as a sole signal for regulated age checks (alcohol, tobacco, gambling). Combine it with an ID scan when compliance matters.