Create Over‑18 Session
Create SessionStatus: 200 OK
Response JSON
{"id":"01d1e65a-54a9-4c76-8f60-cb30b87b1b03","status":"PENDING","expires_at":"2026-05-31T16:41:10Z"}
Testing Return flows
COMPLETEDFAILED
ABANDONED
EXPIRED
ONLY session_id
Diagnostics
General
- MethodPOST
- URLhttps://age.yoti.com/api/v1/sessions
Request Headers
Authorization: Bearer GiT5rA3uO_V6GjaoIsGUQW_KEW-KkR_4q8c9u940LXHoc6fvkXlmRATWLZA=
Yoti-SDK-Id: 032a7ca8-bc0a-4931-98f2-e7fbc9e5a191
Accept: application/json
Content-Type: application/json; charset=utf-8
Request Body
{
"type": "OVER",
"age": 18,
"ttl": 900,
"reference_id": "pintfinder_1780244769",
"callback": { "auto": true, "url": "https://pintfinderyoti.nexpreview.co.uk/age/return" },
"notification_url": "https://pintfinderyoti.nexpreview.co.uk/age/webhook",
"age_estimation": { "allowed": false },
"doc_scan": {
"allowed": true,
"retry_enabled": true
},
"digital_id": { "allowed": false },
"synchronous_checks": true,
"retry_enabled": true,
"resume_enabled": true
}
Response
Status: 200
Response Headers
Date: Sun, 31 May 2026 16:26:10 GMT
Connection: keep-alive
Server: cloudflare
X-Request-ID: d344892a1c1c8b91081188fc16259183, d344892a1c1c8b91081188fc16259183
cf-cache-status: DYNAMIC
Set-Cookie: __cf_bm=O8eqhejRnvIp0zEJm_IWe4mjTmiQDxQ9Xyg83xbtzJg-1780244770.0466833-1.0.1.1-TfP0_IpTegGJdxZ4IHCkCAKG3898NxjD6Jocx5E.XoXYYUNvCqy8P1GHxVnRFPp9Ron_9obahbF0V9NHlMDhksoqqw1pjDg8_nItGA8GhuTfyqBKAueoftoXrwk3inG6; HttpOnly; Secure; Path=/; Domain=yoti.com; Expires=Sun, 31 May 2026 16:56:10 GMT
CF-RAY: a04756b4cada0c49-AMS
Content-Type: application/json
Content-Length: 100
Config (from appsettings.json)
- SdkId (Yoti Age Verification)
- ApiToken (Bearer)
- BaseAddress (https://age.yoti.com/api/v1/)
- ReturnUrl and WebhookUrl