---
title: "List User Accounts"
method: GET
path: "/users/{userID}/accounts"
tags: ["Accounts"]
---

# List User Accounts

`GET /users/{userID}/accounts`

Retrieves a list of User Accounts by userID, including joint accounts the user co-owns.

## Path parameters

- `userID` string, required

## Response `200`

Retrieving a list of User Accounts by userID was Successful.

- Account[] — A list of all the user's accounts at DriveWealth.
  - `id` string — The user's unqiue account identifier.
  - `accountNo` string — The user's unqiue account number, that is human readable.
  - `nickname` string
  - `status` 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` object
    - `name` 'CASH' | 'MARGIN' | 'CRYPTO' — The type of trading ocurring in the account.
    - `description` string — A custom description about the type of account.
  - `leverage` number — The leverage that is applied to the user's account.
  - `commissionID` string — The unique identifier for the assiocated commission schedule.
  - `userID` string — The user's unique identifier.
  - `restricted` boolean — True, if the user is restricted from trading.
  - `goodFaithViolations` number — The amount of times that a user buy a security and sell it before paying for the inital purchase in full with settled funds.
  - `patternDayTrades` number — The number of times a user buys and sells the same security in the same day over a seven-day period.
  - `freeTradeBalance` number
  - `gfvPdtExempt` boolean
  - `buyingPowerOverride` boolean — True, if buying power check turned off.
  - `bod` object — Beginning of Day Information, *⚠️ Only updated at the beginning of day, this information will not change interaday.*
    - `moneyMarket` number — The amount of money the user's has in money market for this account.
    - `equityValue` number — The value of the sum of all equities in the account.
    - `cashAvailableForWithdrawal` number — The amount of money available for withdrawal.
    - `cashAvailableForTrading` number — The amount of money available for trading.
    - `updatedWhen` string — The date and time the dob job was run.
  - `cashBalance` number — The amount of settled cash in the account.
  - `sweepInd` boolean — True, if the user's account cash is set to move into a bank sweep or money market account.
  - `interestFree` boolean — True, if the user will not be paid interest on the money in a bank sweep or money market account.
  - `createdWhen` string — The createdWhen is the date and time the user's account was created.
  - `updatedWhen` string — The updatedWhen is the last date and time the user's account was updated.
  - `lastActivityDate` string — The date indicating the last recorded activity of the account, across the partner's ecosystem. It's important to update this field regularly, as activity recency may impact functions like escheatment, and there may be activity occuring outside of the DriveWealth APIs.
  - `interestedParties` InterestedParty[]
    - `type` 'AUTHORIZED_USER' | 'CUSTODIAN' — The type of interested party.
    - `data` union[] — The list of interested parties. The shape of each item is determined by the sibling `type` field: when `type` is `AUTHORIZED_USER`, each item follows `interestedPartyAuthorizedUser`; when `type` is `CUSTODIAN`, each item follows `interestedPartyCustodian`. The item itself does not repeat the `type` field.
      - union
        - InterestedPartyAuthorizedUser
          - `id` string, required — A unique identifier created for each User on DriveWealth's platform.
          - `reportingRole` 'AUTH3RD' | 'AUTHREP' | 'NTHOLDER' | 'TRDHOLDER', required — The role of the interested party of the ID.
          - `tradeDiscretion` boolean, required — The trade discretion of the interested party of the ID.
          - `from` string, date-time, required — Time when the interested party role started
          - `to` string, date-time — Time when the interested party role ended
          - `endReason` 'CORRECTION' | 'ENDED' | 'INACTIVE' | 'REPLACED' | 'OTHER' | 'TRANSFER' — The reason the interested party role ended.
        - InterestedPartyCustodian
          - `id` string, required — A unique identifier created for each User on DriveWealth's platform.

---

[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)