---
title: "Get Sub-Account KYC URL"
method: POST
path: "/api/v4/sub-account/kyc-url"
tags: ["Sub-Account"]
---

# Get Sub-Account KYC URL

`POST /api/v4/sub-account/kyc-url`

The endpoint generates a temporary KYC verification link for a [sub-account](/glossary#sub-account).

<Note>
The sub-account must meet all of the following conditions before a KYC URL can be generated:
- The sub-account must be activated (have an associated user).
- The sub-account must be active (not locked or blocked).
- The sub-account must not have shared KYC enabled.
</Note>

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

<Note>
The API does not cache the response.
</Note>

## Request body

- object
  - `id` string, required — Sub-account external ID. Must belong to the authenticated main account.

## Response `200`

KYC URL generated successfully

- object
  - `url` string, required — Temporary KYC verification URL
  - `expiresIn` integer, required — Time in seconds until the link expires

## Other responses

- `400` — Request validation failed
- `401` — Invalid API key, signature, or nonce
- `404` — Not found — the authenticated user does not have sub-account crypto service permission

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)