---
title: "Retrieve Withdrawal"
method: GET
path: "/funding/redemptions/{redemptionID}"
tags: ["Withdrawals"]
---

# Retrieve Withdrawal

`GET /funding/redemptions/{redemptionID}`

Retrieves a Withdrawal by redemptionID.

## Path parameters

- `redemptionID` string, required — A unique identifier for the user's account redemption/withdrawal.

## Response `200`

Retrieving a Withdrawal by redemptionID was Successful.

- WithdrawalByRedemptionID
  - `id` string — The unique identifier of the redemption/withdrawal.
  - `category` string — The category 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.
  - `created` string
  - `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.
  - `batch` boolean
  - `transactionCode` TransactionCodeObject
    - `code` 'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
    - `type` 'CSR' | 'CSD'
    - `description` string — A custom description about the transaction code.
  - `statusHistory` WithdrawalStatusHistoryObject[] — A list of the status history of the withdrawal.
    - `status` 1 | 2 | 3 | 4 | 11 | 12 | 13 | 14 | 15 | 16 | -1 — The current status of the user's redemption/withdrawal in integer form.
    - `statusMessage` 'STARTED' | 'PENDING' | 'SUCCESSFUL' | 'FAILED' | 'OTHER' | 'RIA_PENDING' | 'RIA_APPROVED' | 'RIA_REJECTED' | 'APPROVED' | 'REJECTED' | '-' — The current status of the user's redemption/withdrawal.
    - `created` string
    - `updatedBy` 'SYSTEM REPORT SERVICE' | 'INSTANT FUNDING BREAKDOWN JOB'
    - `comment` string — A custom description that describes the current status of the redemption/withdrawal.
  - `details` WithdrawalDetailsObject
    - `beneficiaryName` string — The full name of the user at the external bank.
    - `beneficiaryAccountNumber` string — The user's external bank account number.
    - `beneficiaryAccountType` 'CHECKING' | 'SAVINGS' — The user's external bank account type.
    - `beneficiaryRoutingNumber` string — The user's external bank account routing number.
    - `beneficiarySwiftABA` string — The user's external bank SWIFT code or ABA number.
    - `beneficiaryBankName` string — The user's external bank name.
    - `beneficiaryBankAddress` string — The user's external bank street address.
    - `beneficiaryBankCity` string — The user's external bank city.
    - `beneficiaryBankProvince` string — The user's external bank state or province.
    - `beneficiaryBankZip` string — The user's external bank postal code.
    - `beneficiaryBankCountry` string — The user's external bank country.
    - `intermediarySwift` string — The SWIFT code of the intermediary bank that is facilitating the international wire transfer.
    - `intermediaryBankName` string — The full name of the intermediary bank that is facilitating the international wire transfer.
  - `wlpFinTranTypeID` string — A unique identifier to id different type of transactions.
  - `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.
  - `note` string — A way to store a message/comment on the this object.
  - `remittanceInformation` string — For ACH, this field will be passed through on an addenda record used for additional remittance details to make it easier for a recipient to identify and apply payments. For wire payments, the field will be passed through as the "Originator to Beneficiary Information", also known as OBI or Fedwire tag 6000. This tag provides specific details about the purpose of the payment to the beneficiary. Character limit vary by bank and rail. Typical limits are 80 characters for ach payments and 140 characters for wire payments.
  - `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.
  - `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/versions/9fced6d0ac41/schema)