Sign in
Age Verification

Start an age-verification session

Creates a session with the active provider (iDenfy or Yoti) and returns a provider-discriminated payload used to load the verification UI. Clients that send no supportedProviders are treated as iDenfy-only.

post/v1/age-verification/session

Request body

supportedProvidersstring[]

Verification providers this client build can render. Absent = legacy client that only understands the iDenfy authToken response.

Example request

{
  "supportedProviders": [
    "idenfy",
    "yoti"
  ]
}

Response

provider'idenfy' | 'yoti' required

Provider the session was created with

authTokenstring

iDenfy authToken to load the verification iframe (provider=idenfy)

sessionIdstring

Yoti AVS session id (provider=yoti)

urlstring

Full Yoti journey URL for the verification iframe (provider=yoti)

Example response

{
  "provider": "idenfy",
  "authToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "sessionId": "28f83246-8977-4f74-87a4-6f23db2bd0c8",
  "url": "https://age.yoti.com?sessionId=...&sdkId=..."
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.