Create Over‑18 Session
Create SessionStatus: 200 OK
Response JSON
{"id":"d6a457d5-8218-4a74-9b11-bde019efa941","status":"PENDING","expires_at":"2025-12-06T03:23:17Z"}
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_1764990497",
"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: Sat, 06 Dec 2025 03:08:17 GMT
Server: yoti-edge-proxy
X-Request-ID: 1cd2453953f594f7a4d5b2b48c098de0, 1cd2453953f594f7a4d5b2b48c098de0
Content-Length: 100
Content-Type: application/json
Config (from appsettings.json)
- SdkId (Yoti Age Verification)
- ApiToken (Bearer)
- BaseAddress (https://age.yoti.com/api/v1/)
- ReturnUrl and WebhookUrl