---
title: "Retrieve KYC"
method: GET
path: "/users/{userID}/kyc-status"
tags: ["Users"]
---

# Retrieve KYC

`GET /users/{userID}/kyc-status`

Retrives a User KYC by userID.

## Path parameters

- `userID` string, required

## Response `200`

Fetching User's Profile Details & KYC is Successful.

- FetchUserKYCResponse
  - `userID` string — A unique identifier created for each User on DriveWealth's platform.
  - `firstName` string — The first name of the user.
  - `lastName` string — The last (family) name of the user.
  - `identity` object
    - `number` string — The user's last 4 digits of their national identification number or tax identification number.
    - `dob` string — The User's date of birth in this format YYYY-MM-DD
  - `accounts` AccountsRequest[] — A list of all the User's accounts.
    - `id` string — The User's unqiue account identifier.
    - `accountNo` string — The User's unqiue account number, that is human readable.
    - `nickname` string
    - `accountStatus` object
      - `name` string — The status of the User's account.
      - `description` string — A custom description about status of the User's account.
    - `accountType` string — The type of account that has been created.
    - `accountManagementType` 'SELF' | 'ADVISORY' | 'RIA_MANAGED' | 'CUSTODIAL' | 'CUSTODIAL_MANAGED' | 'RESERVED' | 'HSA_SELF' | 'HSA_ADVISORY' | 'HSA_RIA_MANAGED' | 'BUSINESS_SELF' | 'BUSINESS_ADVISORY' | 'BUSINESS_RIA_MANAGED' — The type of account who has trading authority.
    - `tradingType` 'CASH' | 'MARGIN' | 'CRYPTO' — The type of trading ocurring in the account.
    - `leverage` number — The leverage that is applied to the User's account.
  - `kyc` object
    - `status` object
      - `name` 'KYC_NOT_READY' | 'KYC_READY' | 'KYC_PROCESSING' | 'KYC_APPROVED' | 'KYC_INFO_REQUIRED' | 'KYC_DOC_REQUIRED' | 'KYC_MANUAL_REVIEW' | 'KYC_DENIED' — The current kyc status of the User.
      - `code` string
      - `description` string — A custom description about the User's KYC status.
    - `approved` object
      - `timestamp` string — The date and time the User's KYC was approved.
      - `approvedBy` string — The identifier of the backoffice user that approved the User's KYC.
    - `accepted` object
      - `acceptedBy` string — The name of the role who approved the User's kyc.
      - `timeStamp` string — The date and time the role who approved the User's kyc.
  - `status` object
    - `name` 'PENDING' | 'APPROVED' — The User's current status.
    - `description` string — A custom description of the User's status.
  - `partnerID` object
    - `id` string — The unique identifier of the firm.
    - `name` string — The firm name.
  - `documents` unknown[] — Please call the user's endpoint to get the User's documents.
    - unknown

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/versions/9fced6d0ac41/schema)