---
title: "Generate a Sumsub KYC access token"
method: POST
path: "/v1/kyc-token"
tags: ["KYC"]
---

# Generate a Sumsub KYC access token

`POST /v1/kyc-token`

Generates a short-lived Sumsub WebSDK access token for the current user so an identity verification flow can be started. Requires a user-scoped access token (authorization code grant); partner-only tokens (client credentials grant) are rejected.

## Request body

- CreateKycTokenRequest
  - `level_name` 'Sorting_KYC_Level' | 'BasicKYCLevel' | 'AccreditationIndividual_FullVerification' — The Sumsub verification level to start. Determines which screens the Sumsub WebSDK shows.
  - `reset` boolean — Reset the Sumsub applicant before issuing the token, so an already-approved level can be executed again (e.g. to update stale PII). Send the kyc_reset value from the requirement status. Must not be sent when refreshing an expired token mid-flow, or the user's in-progress submission is wiped.

## Response `200`

Successful response.

- KycToken
  - `object` 'kyc_token', required — String representing the object's type. Objects of the same type share the same value.
  - `token` string, required — Short-lived Sumsub WebSDK access token scoped to the current user

## Other responses

- `default` — Error response.

---

[API](https://skmtc.dev/coinlist/apis/frontline-api.md) · [All operations](https://skmtc.dev/coinlist/apis/frontline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coinlist/frontline-api/revisions/fa411ea1bdfb/schema)