Create session
Creates an age estimation session. On creation, your balance is checked for the age-estimation fee (and, when escalation is DOC, also for a document scan); if funds are insufficient the request is rejected.
Authorizations
The request must contain basic auth headers where username is API key and password is API secret.
In order for you to start using our API you will need an API key and API secret.
Both can be retrieved by contacting iDenfy's support or iDenfy's sales team.
Body
Minimum age the end user must meet.
1 <= x <= 120Minimum model confidence to accept an estimate without a step-up.
0 <= x <= 100Age band (in years) around min_age that triggers a step-up instead of an immediate decision. Must not exceed min_age. Applies to the AI estimate only, never to a document-derived age.
0 <= x <= 20Action when the estimate is uncertain. DOC = document step-up; NONE = resolve as UNCERTAIN.
DOC, NONE Max estimation attempts before the session locks.
1 <= x <= 3Whether the analysed selfie is stored for sessions from this token.
Token validity window in minutes from creation.
5 <= x <= 1440Redirect after a SUCCESS outcome (blank = built-in result screen).
2048Redirect after an UNDERAGE outcome.
2048Redirect after a terminal UNCERTAIN outcome.
2048Per-session override for where the result notification is sent. Blank = use your account's default Age Estimation webhook notification.
2048Your own identifier for the end user; echoed back in the result webhook for correlation.
100Response
Opaque session credential used by the capture page.
URL to send the end user to.
Absolute UTC expiry.
DOC, NONE Related topics
Creating a KYB SessionID Verification (KYC)Sole Proprietorship Workflow StepGambling and GamingDynamic Workflows