---
title: "Create Managed KYC Check"
method: POST
path: "/api/v2/entities/{entity_id}/kyc/url"
tags: ["KYC"]
---

# Create Managed KYC Check

`POST /api/v2/entities/{entity_id}/kyc/url`

Create a Dinari-managed KYC Check and get a URL for your end customer to interact with.

The URL points to a web-based KYC interface that can be presented to the end customer for KYC verification.
Once the customer completes this KYC flow, the KYC check will be created and available in the KYC API.

## Request body

- CreateManagedKycInput — Input for creating a managed KYC check.
  - `jurisdiction` 'BASELINE' | 'US'

## Response `200`

OK

- ManagedKycEmbed — URL for a managed KYC flow for an `Entity`.
  - `embed_url` string, required — URL of a managed KYC flow interface for the `Entity`.
  - `expiration_dt` string, date-time, required — Datetime at which the KYC request will expired. ISO 8601 timestamp.

## Other responses

- `422` — Unprocessable Entity
- `default` — Default error response

---

[API](https://skmtc.net/dinaricrypto/apis/dinari-enterprise-api.md) · [All operations](https://skmtc.net/dinaricrypto/apis/dinari-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dinaricrypto/dinari-enterprise-api/revisions/5403e9118588/schema)