v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Fiat

Initiate KYC verification for a user

Initiates KYC verification process for a user with the configured provider

post/v1/users/{user_id}/fiat/kyc

Path parameters

user_idstring required

The ID of the user to initiate KYC for

Headers

privy-app-idstring required

ID of your Privy app.

Request body

OR

Response

KYC verification status

provider_user_idstring
status'not_found' | 'active' | 'awaiting_questionnaire' | 'awaiting_ubo' | 'incomplete' | 'not_started' | 'offboarded' | 'paused' | 'rejected' | 'under_review' required

Status of the KYC verification process.

user_idstring required

Example response

{
  "provider_user_id": "303912cc-74fa-4f7a-9c51-2945b40ac09a",
  "status": "under_review",
  "user_id": "cmaftdj280001ww1ihwhy57s3"
}