---
title: "Get a KYC link for a user"
method: POST
path: "/v1/users/{user_id}/fiat/kyc_link"
tags: ["Fiat"]
---

# Get a KYC link for a user

`POST /v1/users/{user_id}/fiat/kyc_link`

## Request

- Base URL: `https://api.privy.io`
- URL: `https://api.privy.io/v1/users/{user_id}/fiat/kyc_link`
- Auth: HTTP basic

Returns a KYC link for a user

## Path parameters

- `user_id` string, required: The ID of the user

## Headers

- `privy-app-id` string, required: ID of your Privy app.

## Request body

- object
  - `provider` 'bridge' | 'bridge-sandbox', required: Valid set of onramp providers
  - `full_name` string
  - `email` string, email, required
  - `type` 'individual' | 'business'
  - `endorsements` string[]
  - `redirect_uri` string

## Response `200`

KYC link for the user

- object
  - `id` string, required
  - `customer_id` string, required
  - `full_name` string, required
  - `email` string, required
  - `kyc_link` string, required
  - `kyc_status` string, required: KYC status reported by Bridge. Passed through as a string so new Bridge statuses remain representable.
  - `rejection_reasons` object[], required
    - `developer_reason` string, required
    - `reason` string, required
    - `created_at` string, required
  - `tos_link` string, required
  - `tos_status` 'pending' | 'approved', required
  - `persona_inquiry_type` string
  - `created_at` string, required

## Changes

- **2026-10-16** `4facbfa7f9d4`: 8 info
  - removed the `approved` enum value from the `kyc_status` response property for the response status `200`
  - removed the `awaiting_ubo` enum value from the `kyc_status` response property for the response status `200`
  - removed the `incomplete` enum value from the `kyc_status` response property for the response status `200`
  - removed the `manual_review` enum value from the `kyc_status` response property for the response status `200`
  - …4 more

[Operation history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/users/:user_id/fiat/kyc_link/post.md)

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) - [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privy-io/apis/privy-api/revisions/3a2288470053?raw)