---
title: "List Withdrawals"
method: GET
path: "/funding/redemptions"
tags: ["Withdrawals"]
---

# List Withdrawals

`GET /funding/redemptions`

Retrieves a list of Withdrawals.

## Query parameters

- `status` 'STARTED' | 'PENDING' | 'SUCCESSFUL' | 'FAILED' | 'OTHER' | 'RIA_PENDING' | 'RIA_APPROVED' | 'RIA_REJECTED' | 'APPROVED' | 'REJECTED' | '-', required — The current status of the user's redemption/withdrawal.
- `type` 'ACH' | 'WIRE' | 'CASH_TRANSFER' | 'BULK_FUNDING', required — The method/form in which the redemption/withdrawal will be sent back to the user's external account.
- `from` string, required
- `to` string, required
- `direction` 'prev' | 'next'
- `parentIBID` string — The partner's unique identifier.

## Response `200`

Retrieving a list of Withdrawals was Successful.

- WithdrawalForTheFirm[] — A list of all redemptions for the firm.
  - `id` string — The unique identifier of the redemption/withdrawal.
  - `paymentID` string — The unique identifier of the redemption/withdrawal.
  - `type` 'ACH' | 'WIRE' | 'CASH_TRANSFER' | 'BULK_FUNDING' — The method/form in which the redemption/withdrawal will be sent back to the user's external account.
  - `amount` number — The amount of the withdrawal
  - `currency` CurrencyObject
    - `name` 'USD' — The name of the currency in abbreviation form.
    - `description` string — A custom description about the currency.
    - `symbol` '$' — The currency symbol.
  - `status` RedemptionStatusObject
    - `id` number — The current status of the user's brokerage account withdraw in integer form.
    - `message` 'STARTED' | 'PENDING' | 'SUCCESSFUL' | 'FAILED' | 'OTHER' | 'RIA_PENDING' | 'RIA_APPROVED' | 'RIA_APPROVED' | 'APPROVED' | 'REJECTED' | '-' — The current status of the user's brokerage account redemption/withdrawal.
    - `updated` string — The last updated timestamp of the status of the user's brokerage account redemption/withdrawal.
  - `userDetails` FundingUserDetails
    - `userID` string — A unique identifier created for each User on DriveWealth's platform.
    - `username` string — The username of the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last (family) name of the user.
    - `email` string — The user's email address.
    - `parentIBID` ParentIBIDObject
      - `id` string — The unique identifier of an associated organization.
      - `name` string — The organization name.
    - `wlpID` string — The wlpID is a deep backoffice ID that identifies each partner from each other.
    - `settlementProfileID` string — A settlement profile identifier that links to a specific bank account for fund settlement.
  - `accountDetails` WithdrawalAccountDetails
    - `accountID` string — The user's unique account identifier.
    - `accountNo` string — The user's unique account number, that is human readable.
    - `accountType` AccountTypeObject
      - `name` string — The type of account that has been created.
      - `description` string — A custom description of the account type.
    - `accountManagementType` AccountManagementTypeObject
      - `name` 'SELF' | 'ADVISORY' | 'RIA_MANAGED' | 'CUSTODIAL' | 'CUSTODIAL_MANAGED' | 'RESERVED' | 'RETIREMENT_TRADITIONAL_SELF' | 'RETIREMENT_TRADITIONAL_ADVISORY' | 'RETIREMENT_TRADITIONAL_RIA_MANAGED' | 'RETIREMENT_ROTH_SELF' | 'RETIREMENT_ROTH_ADVISORY' | 'RETIREMENT_ROTH_RIA_MANAGED' | 'TRUST_SELF' | 'TRUST_ADVISORY' | 'TRUST_RIA_MANAGED' | 'HSA_SELF' | 'HSA_ADVISORY' | 'HSA_RIA_MANAGED' | 'BUSINESS_SELF' | 'BUSINESS_ADVISORY' | 'BUSINESS_RIA_MANAGED' | 'JOINT_SELF' | 'JOINT_ADVISORY' | 'JOINT_RIA_MANAGED' | 'TRUMP_SELF' — The type of account who has trading authority.
      - `description` string — A custom description of the account management type.
  - `fees` FeeObject[] — A list of fees associated to the withdrawal.
    - `type` 'FEE_ACH', required — The type of fee that is being applied.
    - `description` string — A custom description that describes the fee type.
    - `amount` number, required — The amount of the fee that is being applied.
    - `wlpFinTranTypeID` string — A unique identifier to id different type of transactions.
    - `transactionCode` 'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
    - `finTranReference` string — The unique identifier that references back to the specific transaction.
    - `created` string — The timestamp of when the fee was charged.
    - `currency` 'USD' — The name of the currency in abbreviation form.
    - `symbol` '$' — The currency symbol.
  - `wlpFinTranTypeID` string — A unique identifier to id different type of transactions.
  - `transactionCode` TransactionCodeObject
    - `code` 'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
    - `type` 'CSR' | 'CSD'
    - `description` string — A custom description about the transaction code.
  - `iraDistribution` 'NORMAL_DISTRIBUTION' | 'EARLY_DISTRIBUTION' | 'EARLY_DISTRIBUTION_PENALTY_EXCEPTION' | 'DIRECT_ROLLOVER' | 'DIRECT_TRANSFER' | 'REQUIRED_MINIMUM_DISTRIBUTION' | 'DISTRIBUTION_TO_BENEFICIARY' | 'RETURN_OF_EXCESS_CONTRIBUTION' | 'QUALIFIED_CHARITABLE_CONTRIBUTION' — The type of redemption/withdrawal from an IRA type of account. Note: Trump accounts follow specific requirements for external account transfers or distributions. Click [here](https://developer.drivewealth.com/apis/v1.82.0/reference/enums?isFramePreview=true#trump-distribution-types) for more details.
  - `iraDistributionSubType` 'SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP_72T' | 'DISABILITY_OR_DEATH' | 'HIGHER_EDUCATION_EXPENSES' | 'FIRST_TIME_HOME_PURCHASE' | 'MEDICAL_EXPENSES' | 'HEALTH_INSURANCE_PREMIUMS' | 'RESERVIST_DISTRIBUTIONS' — These types are only applicable for the distribution type EARLY_DISTRIBUTION_PENALTY_EXCEPTION. Click [here](https://developer.drivewealth.com/apis/reference/enums#ira-distribution-subtypes) for more details.",

---

[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/revisions/9fced6d0ac41/schema)