> ## Documentation Index
> Fetch the complete documentation index at: https://guides.saber.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiate KYC (Generate KYC URL) (v1)

> Initiate KYC flow for the user. This generates KYC Partner URL for the user.

This is only required for USD onramp flow. Please refer to guide section for KYC flows for other jurisdictions.



## OpenAPI

````yaml /openapi-v1.json post /api/v1/user/client_user/kyc/initiate
openapi: 3.1.0
info:
  title: Saber Money API (v1)
  version: v1
  description: >-
    ## Authentication


    There is no standalone API-key auth — every request must be **signed**. An
    API key by itself authenticates nothing. Each call requires four headers
    together: `X-Api-Key` (your key), `X-Signature` (HMAC-SHA256 of `apiKey +
    timestamp` — or `apiKey + timestamp + userId` when `X-User-Id` is required —
    keyed with your API secret), `X-Timestamp` (unix seconds), and
    `X-Request-Id` (any unique string per request). The signature must be
    computed by a client script; there is no way to derive it by hand. Use the
    HMAC Generator flow to compute valid values for manual testing.


    ## Common Authentication Errors


    - **Invalid Client ID**: {"error_code":6092,"message":"X-Client-Id
    invalid","success":false}

    - **Invalid Secret**: {"error_code":6090,"message":"invalid
    secret","success":false}

    - **Timestamp (Older than 10 secs)**:
    {"errors":{"error_code":6093,"text":"timestamp expired"},"success":false}
servers:
  - url: https://api.saber.money
security: []
paths:
  /api/v1/user/client_user/kyc/initiate:
    post:
      tags:
        - KYC and EDD Operations
      summary: Initiate KYC (Generate KYC URL) (v1)
      description: >-
        Initiate KYC flow for the user. This generates KYC Partner URL for the
        user.


        This is only required for USD onramp flow. Please refer to guide section
        for KYC flows for other jurisdictions.
      operationId: initiate-kyc-generate-kyc-url-v1
      parameters:
        - name: X-Api-Key
          in: header
          required: true
          description: Your API key (configured in credentials)
          schema:
            type: string
        - name: X-Signature
          in: header
          required: true
          description: >-
            HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256
            of `apiKey + timestamp` (or `apiKey + timestamp + userId` when
            X-User-Id is required), keyed with your API secret. The HMAC
            Generator flow computes this for you.
          schema:
            type: string
        - name: X-Timestamp
          in: header
          required: true
          description: >-
            Unix timestamp in seconds (auto-generated) Unix seconds, e.g.
            `Math.floor(Date.now() / 1000)`. Must match the timestamp used in
            the X-Signature computation.
          schema:
            type: string
        - name: X-Request-Id
          in: header
          required: true
          description: >-
            Unique request identifier (auto-generated) Any unique string per
            request, e.g. a UUID.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                country:
                  type: string
                  description: The country field
              required:
                - country
            example:
              country: IND
              kyc_level: kyc-global
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema: {}
              example:
                success: true
                data: User KYC initiated successfully

````

## Related topics

- [KYC Partner URL](/user/kyc/partner-url.md)
- [Overview](/user/kyc/overview.md)
- [KYC Widget](/user/kyc/widget.md)
- [Through Saber Widget](/user/bank-account/widget.md)
- [Triggering Limit Upgrade and EDD](/users/limits-edd/widget.md)