> For the complete documentation index, see [llms.txt](https://finext.gitbook.io/one-kyc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://finext.gitbook.io/one-kyc/api/sessions.md).

# Sessions

A verification session represents a single execution of the verification flow by an end user: document upload, selfie, liveness check, and any other steps configured in the flow. A session is created automatically when the user opens a **verification link** (see [Verification links](/one-kyc/api/verification-links.md)); the user goes through every step on the OneKYC verification page.

## Creating a session

In the Tenant API, sessions are created through the verification-link endpoints. When the user opens the link, a new verification session is initialised automatically.

<mark style="color:green;">`POST`</mark> `undefined/v1/kyc/verification-links`

<mark style="color:green;">`POST`</mark> `undefined/v1/kyc/verification-links/batch`

For full link-management details, see [Verification links](/one-kyc/api/verification-links.md).

## Session lifecycle

A session goes through the following stages:

1. **Creation** — the session is initialised when the verification link is activated.
2. **In progress** — the user works through the steps in order (document upload, selfie, liveness, etc.).
3. **Completion** — once all checks finish, the session receives a final status: approved, rejected, or routed to manual review.

## Fetching applicant session data

The list of verification sessions for an applicant and the verification results are available through the endpoints below (required scopes: **applicants:read**, **verifications:read**):

<mark style="color:blue;">`GET`</mark> `undefined/v1/kyc/applicants/{applicant_id}/sessions`

<mark style="color:blue;">`GET`</mark> `undefined/v1/kyc/applicants/{applicant_id}/verification`

***

For the full request and response field specification, see [API reference (OpenAPI)](/one-kyc/api/api-reference.md).