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

# KYC API

Create identity verification users, obtain verification links, and query KYC status.

Hosted identity verification for merchants enabled for the standalone KYC product.

## Endpoints

| Endpoint                                                                                        | Path                            | Description                                                                     |
| ----------------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------- |
| [Create Applicant](https://docs.musepay.io/reference/api-reference/kyc-api/create-applicant.md) | `POST /v1/kyc/applicant/create` | Create or retrieve a verification user under your merchant account.             |
| [Get Verification Link](https://docs.musepay.io/reference/api-reference/kyc-api/link.md)        | `POST /v1/kyc/link`             | Start a chargeable verification and obtain a hosted link.                       |
| [Query KYC Status](https://docs.musepay.io/reference/api-reference/kyc-api/query.md)            | `POST /v1/kyc/query`            | Read the latest application's level and status, and the level already obtained. |

All three require the [common parameters](https://docs.musepay.io/reference/api-reference/common-parameters.md) and a signed merchant request. Examples on these pages show business fields only.

## Related documentation

* [KYC Integration Guide](https://docs.musepay.io/integration/kyc-api.md): workflow, levels, fees, results, and error handling.
* [KYC Merchant Webhook](https://docs.musepay.io/integration/webhook/kyc.md): final result notifications and their security properties.
