> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.kravata.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate KYC Link

> Generates the identity verification (KYC) link for one of your users. Send the returned URL to the user so they complete the verification.

#### Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | `Bearer <access_token>` obtained from **POST /api/v1/client/token**. |
| user_id | Path | Yes | Identifier of the user, from **GET /api/v1/admin/users**. |
| template_id | Query | No | KYC template to use for the verification flow. |
| custom_metadata_name | Query | No | Custom metadata name to attach to the verification session. |

#### Response

| Field | Description |
| --- | --- |
| url | The KYC verification link to send to the user. |



## OpenAPI

````yaml /stack/openapi.json post /api/v1/provider/kyc/user/generateurl/{user_id}
openapi: 3.1.0
info:
  title: Kravata Stack API
  version: '2.0'
  description: >-
    Kravata Stack API: users, accounts, custody wallets, liquidity ramps and
    fiat payments.
servers:
  - url: https://test-api-kore.kravata.co
    description: Test
  - url: https://partners-api.kravata.co
    description: Production (mTLS + IP allowlist)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Users
  - name: Accounts
  - name: Earn
  - name: Custody
  - name: Liquidity Ramps
  - name: Payments
  - name: Webhooks
paths:
  /api/v1/provider/kyc/user/generateurl/{user_id}:
    post:
      tags:
        - Users
      summary: Generate KYC Link
      description: >-
        Generates the identity verification (KYC) link for one of your users.
        Send the returned URL to the user so they complete the verification.


        #### Request


        | Field | Type | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | `Bearer <access_token>` obtained from
        **POST /api/v1/client/token**. |

        | user_id | Path | Yes | Identifier of the user, from **GET
        /api/v1/admin/users**. |

        | template_id | Query | No | KYC template to use for the verification
        flow. |

        | custom_metadata_name | Query | No | Custom metadata name to attach to
        the verification session. |


        #### Response


        | Field | Description |

        | --- | --- |

        | url | The KYC verification link to send to the user. |
      operationId: generate-kyc-link
      parameters:
        - name: user_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````