---
title: "Get the current onboarding session"
method: GET
path: "/api/fma/v1/kyc/session/current"
tags: ["Managed Custody KYC"]
---

# Get the current onboarding session

`GET /api/fma/v1/kyc/session/current`

Returns the current onboarding state for the user. Poll it after the user starts the Sumsub SDK to detect the SignFormA state; the state can lag the SDK UI by a few seconds because Sumsub webhooks drive the transitions. Returns NO_ACTIVE_SESSION (code 30031) when the user has no active session, including after the session reaches a terminal outcome.

## Headers

- `X-Ur-Id` string
- `X-External-User-Id` string
- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required

## Response `200`

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

- KycSessionCurrentResponse
  - `code` integer — Business result code. 0 means success; business rejections return HTTP 200 with a non-zero code.
  - `message` string — Human-readable diagnostic for non-zero codes.
  - `data` object
    - `sessionId` string — UUID of the active onboarding session.
    - `flowId` integer — Internal flow id for the session.
    - `retryLevel` integer — Increments each time the user starts a fresh onboarding attempt after a previous one terminated.
    - `state` string — Current session state, in onboarding order: ConfirmYourCountryOfResidence, AddressProof, UnderstandRisk, LiabilityWaiver, IdOrPassportOrOtherIdInformationScan, IdAndLiveness, SignFormA, Register. Treat any unlisted value as an in-progress state. Terminal outcomes are reported by the fma.account.result webhook, after which this endpoint returns NO_ACTIVE_SESSION (code 30031).
    - `dataChannel` string — Onboarding path of the session; sdk for the Sumsub SDK path. Any other value indicates a partner configuration issue for that path.
    - `createdAt` integer — Session creation time, Unix seconds.
    - `lastUserActivityAt` integer — Last user activity time, Unix seconds.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)