v1

latestOpenAPI 3.0.22026-07-24113565544.0 KB

Users

Retrieve KYC

Retrives a User KYC by userID.

get/users/{userID}/kyc-status

Path parameters

userIDstring required

Unique ID of the User to fetch their profile & kyc status.

Response

Fetching User's Profile Details & KYC is Successful.

userIDstring

A unique identifier created for each User on DriveWealth's platform.

firstNamestring

The first name of the user.

lastNamestring

The last (family) name of the user.

Example response

{
  "userID": "cc07f91b-7ee1-4868-b8fc-823c70a1b932",
  "firstName": "Justin",
  "lastName": "Smith",
  "identity": {
    "number": "****-4444",
    "dob": "2000-12-03"
  },
  "accounts": [
    {
      "id": "8b8ba3fd-74dc-45dc-b2dc-7de683bd713c.1556222995391",
      "accountNo": "DWBG000052",
      "nickname": "Justin's Self Directed Account",
      "accountStatus": {
        "name": "PENDING",
        "description": "Pending"
      },
      "accountType": "LIVE",
      "accountManagementType": "SELF",
      "tradingType": "CASH",
      "leverage": 1
    }
  ],
  "kyc": {
    "status": {
      "name": "KYC_INFO_REQUIRED",
      "code": "K102",
      "description": "User's PII not matched. Please revisit user's PII Info."
    },
    "approved": {
      "timestamp": "2022-12-12T21:13:12.391Z",
      "approvedBy": "0ef9ef36-3720-4b76-a938-dac4501a7f95"
    },
    "accepted": {
      "acceptedBy": "SYSTEM PRINCIPAL APPROVER",
      "timeStamp": "2022-12-12T21:13:12.391Z"
    }
  },
  "status": {
    "name": "APPROVED",
    "description": "User approved."
  },
  "partnerID": {
    "id": "80f9b672-120d-4b73-9cc9-42fb3262c4b9",
    "name": "Tendies Trading Company"
  },
  "documents": []
}