Age Estimation
Privacy-first age checks - no document needed.
Most users are obviously old enough - make only the borderline cases show ID. Age Estimation reads age from a liveness-checked selfie in under a second, letting clearly-eligible users straight through and routing only near-threshold faces to a document check.
Capabilities
What Age Estimation gives you.
Selfie-only age check
An age estimate from a single selfie - no document, no account, no typing.
Buffer thresholds
Set challenge bands (e.g. “verify if estimated under 25”) so error margins never admit minors.
Anonymous by design
Estimation can run without storing the image or identifying the user - ideal for content gates.
Liveness included
Photos of adults can’t be used by minors - every estimate runs on a liveness-checked live face.
Document fallback
Near-threshold users hand off seamlessly to ID verification in the same flow.
Regulator-aware
Supports age-assurance regimes for iGaming, social platforms and age-restricted commerce.
From session to signed result.
Four steps - the same integration pattern as every Amani module.
Create a session
One API call (or a Studio journey) starts a verification session for this module.
User completes the flow
Your customer is guided through capture in your branded UI - web or mobile.
Checks run in real time
Age Estimation executes alongside any other modules in the journey.
You receive a signed result
A webhook delivers the decision, scores and evidence to your backend.
For developers
Integrate Age Estimation.
Authenticate, create a profile, generate a verification URL - then let Amani handle the rest. Or describe what you want to your AI coding agent and let Amani Skills wire it up from the live docs.
Available on
verify.sh
# 1 · Authenticate (server-side only)
curl -X POST 'https://ae.amani.ai/api/v2/user/login/' \
--form 'username="you@company.com"' \
--form 'password="••••••••"'
# 2 · Create the customer profile
curl -X POST 'https://ae.amani.ai/api/v2/profile' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
--form 'id_card_number="784199012345678"' \
--form 'name="Layla Haddad"'
# 3 · Generate the verification URL
curl -X POST 'https://ae.amani.ai/api/v2/profile/url' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
--data '{
"profile": PROFILE_ID,
"web_sdk_url": "https://verify.amani.ai",
"language": "en",
"return_url": "https://yourapp.com/verified"
}'
# Age Estimation runs inside this session - configure it in Amani Studio.with Amani Skills
# Install Amani Skills once
npx -y github:AMANI-AI-ORG/skills --global
# Then ask your coding agent:
You › Add an Amani age check to our web signup that only asks for ID when the estimate is near our threshold.
# The matching skill fetches the live docs, pins the
# current SDK version and wires up the integration -
# secrets left as placeholders. Claude Code, Cursor and
# any Agent-Skills-compatible tool.webhooks.ts
// Amani signs every webhook with an HMAC signature using
// your secret. Always verify it before processing.
import crypto from 'node:crypto';
app.post('/webhooks/amani', (req, res) => {
// Confirm the exact header name in the Webhooks API reference.
const signature = req.get('X-Amani-Signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.AMANI_WEBHOOK_SECRET)
.update(req.rawBody)
.digest('hex');
const valid =
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
if (!valid) return res.status(401).end();
const { profile, status } = req.body;
if (status === 'approved') activateAccount(profile);
res.status(200).end();
});Age Estimation - common questions
How accurate is estimation?
Estimation returns an age range rather than a single number, and you set a buffer so anyone near your threshold steps up to a document check. That buffer is what guarantees minors are not admitted, rather than the estimate alone.
Is a face image stored?
Only if you configure it. Pure age-gate deployments run statelessly: estimate, decide, discard.
Which rules does this satisfy?
Buffer-based estimation with document step-up is the pattern accepted by major age-assurance regimes for gambling, adult content and social media - we help you map it to your regulator.
Related modules
Add Age Estimation to your flow
Switch it on in Amani Studio, or call it directly from the API.