Sign in

v1

latestOpenAPI 3.0.22026-07-24113565544.0 KB
Withdrawals

Create Withdrawal

Creates a Withdrawal.

post/funding/redemptions

Headers

Idempotency-Keystring
Example:a1b2c3d4-5e6f-7g8h-9i0j-1k2l3m4n5o6

A unique key (UUID) that is used to prevent duplicate requests. Should a network interruption occur, or you otherwise lost a response from the API, you can safely perform the request provided that you send the same value as the Idempotency-Key. DriveWealth Idempotency Keys are saved for 4 days. Within this time period, sending any request with a duplicate key will return the exact same response as the original request, including the same status code and payload.

Request body

accountNostring required

The user's unique account number, that is human readable.

amountnumber 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.

bankAccountIDstring

The unique DriveWealth identifier that identifies each linked bank 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 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 for more details.",

liquidateboolean

True, if the account is a managed account and a full liquidation is requested from the user.

notestring

A way to store a message/comment on the this object.

remittanceInformationstring

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.

settlementProfileIDstring

A settlement profile identifier that links to a specific bank account for fund settlement.

Example request

{
  "accountNo": "DWBG000052",
  "amount": 125.92,
  "currency": "USD",
  "type": "ACH",
  "bankAccountID": "bank_a4656e60-321e-425b-aa0d-a2e75c38885f",
  "details": {
    "beneficiaryName": "Justin Smith",
    "beneficiaryAccountNumber": "00257596002028990212396",
    "beneficiaryAccountType": "CHECKING",
    "beneficiaryRoutingNumber": "021000322",
    "beneficiarySwiftABA": "BOFAUS3NXXX",
    "beneficiaryBankName": "Bank of America",
    "beneficiaryBankAddress": "222 BROADWAY",
    "beneficiaryBankCity": "New York City",
    "beneficiaryBankProvince": "New York",
    "beneficiaryBankZip": "10038",
    "beneficiaryBankCountry": "USA",
    "intermediarySwift": "CHASUS3AXXX",
    "intermediaryBankName": "J.P Morgan Chase & Co."
  },
  "iraDistribution": "EARLY_DISTRIBUTION_PENALTY_EXCEPTION",
  "iraDistributionSubType": "SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP_72T",
  "iraTaxWithholdings": {
    "federalTaxPercentage": 0.1,
    "stateTaxPercentage": 0.1
  },
  "fees": [
    {
      "type": "FEE_ACH",
      "description": "Fee - ACH",
      "amount": -5.99,
      "wlpFinTranTypeID": "c43bab85-2916-4831-a0db-66215150a6e4",
      "transactionCode": "JOURNAL",
      "finTranReference": "HG.cd22a78a-8a48-441c-89d2-ea400964a34b",
      "created": "2022-12-11T22:28:21.810Z",
      "currency": "USD",
      "symbol": "$"
    }
  ],
  "note": "Hey! Welcome to DriveWealth Developer Docs!",
  "remittanceInformation": "Withdrawal from investment account",
  "settlementProfileID": "settlement-profile-bank-account-1"
}

Response

Creating a User's Account Withdrawal was successful.

idstring

The unique identifier of the redemption/withdrawal.

accountNostring

The user's unique account number, that is human readable.

categorystring

The category of the withdrawal.

currency'USD'

The name of the currency in abbreviation form.

amountnumber

The amount of the withdrawal.

paymentRefstring

The unique identifier of the redemption/withdrawal.

createdstring

The date and time the when the withdrawal was created.

accountIDstring

The user's unique account identifier.

userIDstring

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

transactionCode'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
wlpFinTranTypeIDstring

A unique identifier to id different type of transactions.

batchboolean

True, if the withdrawal will be batched.

account_numberstring

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 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 for more details.",

remittanceInformationstring

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.

Example response

{
  "id": "-RIUIN",
  "accountNo": "DWBG000052",
  "category": "REDEMPTION",
  "currency": "USD",
  "amount": -560.36,
  "status": {
    "id": 1,
    "message": "PENDING",
    "updated": "2022-12-11T22:28:21.810Z"
  },
  "source": {
    "id": "ACH",
    "meta_info": "Hey! Welcome to DriveWealth Developer Docs!"
  },
  "paymentRef": "-RIUIN",
  "created": "2022-12-08T18:36:40.609Z",
  "accountID": "cc07f91b-7ee1-4868-b8fc-823c70a1b932.1407775317759",
  "userID": "cc07f91b-7ee1-4868-b8fc-823c70a1b932",
  "transactionCode": "JOURNAL",
  "wlpFinTranTypeID": "c43bab85-2916-4831-a0db-66215150a6e4",
  "batch": true,
  "account_number": "DWBG000052",
  "iraDistribution": "EARLY_DISTRIBUTION_PENALTY_EXCEPTION",
  "iraDistributionSubType": "SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP_72T",
  "remittanceInformation": "Withdrawal from investment account"
}