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

  • Base URL
    https://api.miaai.chat (the document declares no server; this is the origin it was published from)
  • URL
    https://api.miaai.chat/v1/age-verification/session
  • Auth
    HTTP bearer

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 operation across all 1 revision of this API.