Create a new age verification session
Creates a new verification session. The user should be redirected to the `verify_url` returned in the response to complete verification.
Authorization
bearerAuth API token obtained from your Bouncer dashboard
In: header
Request Body
application/json
The minimum age to verify. User must be at least this age for verification to succeed.
8 | 13 | 16 | 18 | 21 | 25 | 30URL to redirect the user after verification completes (success or failure)
urilength <= 2048If true, always require ID document verification regardless of age estimation result
falseIf true, the user must complete full verification every time; the verification cookie is not used to skip verification
falseCustom key:value pairs to attach to the session (e.g., ['order_id:123', 'user_id:456'])
URL to receive webhook notifications when the session status changes
urilength <= 2048Session expiration time in seconds (default: 300 = 5 minutes)
30060 <= value <= 3600Response Body
application/json
application/json
application/json
curl -X POST "https://app.bouncer.digital/api/v2/session" \ -H "Content-Type: application/json" \ -d '{ "age_target": 18, "redirect_url": "https://your-app.com/callback", "force_verification": true, "webhook_url": "https://your-app.com/webhooks/bouncer", "metadata": [ "order_id:12345", "user_id:67890" ], "expiration_time": 300 }'{
"data": {
"id": "019cd88b-ec3c-7189-8dfa-914f801ff505",
"verify_url": "https://app.bouncer.digital/verify/019cd88b-ec3c-7189-8dfa-914f801ff505",
"issued_at": 1773159574,
"expires_at": 1773159874
}
}{
"message": "Unauthenticated."
}{
"message": "The age_target field is required.",
"errors": {
"age_target": [
"The age_target field is required."
],
"redirect_url": [
"The redirect_url must be a valid URL."
]
}
}