> 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.

{% hint style="warning" %}
**Not yet released (documentation preview)**: KYC OpenAPI has not been released to production. This documentation is for integration planning only; API definitions and business rules may change before release. Do not use it for production workloads. Contact MusePay to confirm test availability and access arrangements. Production availability will be announced separately.
{% endhint %}

The KYC API provides hosted identity verification for merchants enabled for the standalone KYC product. Before integrating, contact MusePay to confirm availability in your target environment, enabled levels, fees, and your merchant callback URL.

## Endpoints

| Endpoint                                                                 | Path                            | Description                                                                                                       |
| ------------------------------------------------------------------------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| [Create Applicant](/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](/reference/api-reference/kyc-api/link.md)        | `POST /v1/kyc/link`             | Initiate a chargeable verification request and obtain a hosted verification link.                                 |
| [Query KYC Status](/reference/api-reference/kyc-api/query.md)            | `POST /v1/kyc/query`            | Retrieve the level and status of the user's most recent application, and the verification level already obtained. |

All three endpoints require the [common parameters](/reference/api-reference/common-parameters.md) and a signed merchant request. Request examples on these pages show business fields only and are not complete requests.

## Related documentation

* [KYC Integration Guide](/integration/kyc-api.md): onboarding, levels, fees, and the end-to-end workflow.
* [KYC Merchant Webhook](/integration/webhook/kyc.md): final result notifications and security considerations.