---
title: "Update KYC status for a user"
method: PATCH
path: "/v1/users/{user_id}/fiat/kyc"
tags: ["Fiat"]
---

# Update KYC status for a user

`PATCH /v1/users/{user_id}/fiat/kyc`

Update the KYC verification status for a user from the configured provider

## Path parameters

- `user_id` string, required — The ID of the user to update KYC status for

## Headers

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

## Request body

- union
  - object
    - `data` object, required
      - `account_purpose` string
      - `account_purpose_other` string
      - `acting_as_intermediary` string
      - `birth_date` string, required
      - `completed_customer_safety_check_at` string
      - `documents` object[]
        - `description` string
        - `file` string, required
        - `purposes` string[], required
      - `email` string, email, required
      - `employment_status` string
      - `endorsements` string[]
      - `expected_monthly_payments_usd` string
      - `first_name` string, required
      - `has_accepted_terms_of_service` boolean
      - `has_signed_terms_of_service` boolean
      - `identifying_information` object[], required
        - `description` string
        - `expiration` string
        - `image_back` string
        - `image_front` string
        - `issuing_country` string, required
        - `number` string
        - `type` string, required
      - `kyc_screen` object
        - `result` 'passed', required
        - `screened_at` string, required
      - `last_name` string, required
      - `middle_name` string
      - `most_recent_occupation` string
      - `nationality` string
      - `ofac_screen` object
        - `result` 'passed', required
        - `screened_at` string, required
      - `phone` string
      - `residential_address` object, required
        - `city` string, required
        - `country` string, required
        - `postal_code` string
        - `street_line_1` string, required
        - `street_line_2` string
        - `subdivision` string, required
      - `signed_agreement_id` string
      - `source_of_funds` string
      - `transliterated_first_name` string
      - `transliterated_last_name` string
      - `transliterated_middle_name` string
      - `transliterated_residential_address` object
        - `city` string, required
        - `country` string, required
        - `postal_code` string
        - `street_line_1` string, required
        - `street_line_2` string
        - `subdivision` string, required
      - `type` 'individual', required
      - `verified_selfie_at` string
    - `provider` 'bridge', required
  - object
    - `data` object, required
      - `account_purpose` string
      - `account_purpose_other` string
      - `acting_as_intermediary` string
      - `birth_date` string, required
      - `completed_customer_safety_check_at` string
      - `documents` object[]
        - `description` string
        - `file` string, required
        - `purposes` string[], required
      - `email` string, email, required
      - `employment_status` string
      - `endorsements` string[]
      - `expected_monthly_payments_usd` string
      - `first_name` string, required
      - `has_accepted_terms_of_service` boolean
      - `has_signed_terms_of_service` boolean
      - `identifying_information` object[], required
        - `description` string
        - `expiration` string
        - `image_back` string
        - `image_front` string
        - `issuing_country` string, required
        - `number` string
        - `type` string, required
      - `kyc_screen` object
        - `result` 'passed', required
        - `screened_at` string, required
      - `last_name` string, required
      - `middle_name` string
      - `most_recent_occupation` string
      - `nationality` string
      - `ofac_screen` object
        - `result` 'passed', required
        - `screened_at` string, required
      - `phone` string
      - `residential_address` object, required
        - `city` string, required
        - `country` string, required
        - `postal_code` string
        - `street_line_1` string, required
        - `street_line_2` string
        - `subdivision` string, required
      - `signed_agreement_id` string
      - `source_of_funds` string
      - `transliterated_first_name` string
      - `transliterated_last_name` string
      - `transliterated_middle_name` string
      - `transliterated_residential_address` object
        - `city` string, required
        - `country` string, required
        - `postal_code` string
        - `street_line_1` string, required
        - `street_line_2` string
        - `subdivision` string, required
      - `type` 'individual', required
      - `verified_selfie_at` string
    - `provider` 'bridge-sandbox', required

## Response `200`

Updated KYC verification status

- object — Response for an onramp KYC verification.
  - `provider_user_id` string
  - `status` 'not_found' | 'active' | 'awaiting_questionnaire' | 'awaiting_ubo' | 'incomplete' | 'not_started' | 'offboarded' | 'paused' | 'rejected' | 'under_review', required — Status of the KYC verification process.
  - `user_id` string, required

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/versions/bb2eb34156cc/schema)