---
title: "Start an age-verification session"
method: POST
path: "/v1/age-verification/session"
tags: ["Age Verification"]
---

# Start an age-verification session

`POST /v1/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.

## Request body

- CreateAgeVerificationSessionDto
  - `supportedProviders` string[] — Verification providers this client build can render. Absent = legacy client that only understands the iDenfy authToken response.

## Response `200`

- CreateAgeVerificationSessionResponseDto
  - `provider` 'idenfy' | 'yoti', required — Provider the session was created with
  - `authToken` string — iDenfy authToken to load the verification iframe (provider=idenfy)
  - `sessionId` string — Yoti AVS session id (provider=yoti)
  - `url` string — Full Yoti journey URL for the verification iframe (provider=yoti)

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)