Verify a user's age in three steps with a hosted verification session. This is the exact flow you can try interactively in the API Playground in your dashboard, the document scan, selfie, and liveness checks all happen on Tuteliq's hosted page, so you never handle the user's ID or biometric data yourself.
How it works
Tuteliq creates a short-lived, hosted verification session and returns a URL. You send your user to that URL, they complete the checks on Tuteliq's page, and you poll the session until it reaches a terminal status.
- Create a session with mode: "age".
- Redirect the user to the returned verification URL.
- Poll the session for the result.
1. Create a session
Send a POST to /api/v1/verify/session with the mode set to age.
The response contains the session ID, the hosted verification URL, and an expiry timestamp:
2. Send the user to verify
Open the url (or mobile_url on mobile) in a new tab, redirect to it, or surface it as a QR code / deep link. The user scans their ID document and completes a selfie liveness check on Tuteliq's hosted page.
3. Poll for the result
Poll GET /api/v1/verify/session/{session_id} every few seconds until status reaches a terminal value. Terminal success values include verified, terminal failures include failed and expired.
A completed, successful session looks like this:
Full example
The complete create → redirect → poll flow in TypeScript:
Next steps
The full end-to-end gating flow, state machine, and compliance guidance.
How Tuteliq confirms a live person is present during verification.