---
title: "Create Withdrawal"
method: POST
path: "/funding/redemptions"
tags: ["Withdrawals"]
---

# Create Withdrawal

`POST /funding/redemptions`

Creates a Withdrawal.

## Headers

- `Idempotency-Key` string

## Request body

- WithdrawalFromUserAccountReq
  - `accountNo` string, required — The user's unique account number, that is human readable.
  - `amount` number, required — The amount of the withdrawal. Accepts positive or negative values; regardless of the sign provided, the withdrawal is stored and processed as a negative amount in the system.
  - `currency` 'USD', required — The name of the currency in abbreviation form.
  - `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.
  - `bankAccountID` string — The unique DriveWealth identifier that identifies each linked bank account.
  - `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.
  - `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.",
  - `iraTaxWithholdings` IraTaxWithHoldings
    - `federalTaxPercentage` number — The percentage amount that should be withheld for federal taxes.
    - `stateTaxPercentage` number — The percentage amount that should be withheld for state taxes.
  - `liquidate` boolean — True, if the account is a managed account and a full liquidation is requested from the user.
  - `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.
  - `settlementProfileID` string — A settlement profile identifier that links to a specific bank account for fund settlement.

## Response `200`

Creating a User's Account Withdrawal was successful.

- WithdrawalFromUserAccount
  - `id` string — The unique identifier of the redemption/withdrawal.
  - `accountNo` string — The user's unique account number, that is human readable.
  - `category` string — The category of the withdrawal.
  - `currency` 'USD' — The name of the currency in abbreviation form.
  - `amount` number — The amount of the withdrawal.
  - `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.
  - `source` object
    - `id` 'ACH' | 'WIRE' | 'CASH_TRANSFER' | 'BULK_FUNDING' — The method/form in which the redemption/withdrawal will be sent back to the user's external account.
    - `meta_info` string — A way to store a message/comment on the this object.
  - `paymentRef` string — The unique identifier of the redemption/withdrawal.
  - `created` string — The date and time the when the withdrawal was created.
  - `accountID` string — The user's unique account identifier.
  - `userID` string — A unique identifier created for each User on DriveWealth's platform.
  - `transactionCode` 'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
  - `wlpFinTranTypeID` string — A unique identifier to id different type of transactions.
  - `batch` boolean — True, if the withdrawal will be batched.
  - `account_number` string — The user's unique account number, that is human readable.
  - `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.",
  - `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.

---

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