DRdrivewealth
Withdrawals

List Withdrawals

Retrieves a list of Withdrawals.

get/funding/redemptions

Request

  • Base URL
    https://bo-api.drivewealth.io/back-office
  • URL
    https://bo-api.drivewealth.io/back-office/funding/redemptions
  • Auth
    HTTP bearer

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.

Example:PENDING

The current status of the withdrawal to filter by.

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.

Example:ACH

The type of withdrawal to filter by.

fromstring required

The date to start from.

tostring required

The date to end at.

direction'prev' | 'next'

The direction of pagination.

parentIBIDstring

The partner's unique identifier.

Example:123e4567-e89b-12d3-a456-000000000005

Filters the withdrawals list by the partnerID.

Response

Retrieving a list of Withdrawals was Successful.

idstring

The unique identifier of the redemption/withdrawal.

paymentIDstring

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.

amountnumber

The amount of the withdrawal

wlpFinTranTypeIDstring

A unique identifier to id different type of transactions.

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.",

Example response

[
  {
    "id": "AAAA009002-1234567890139-RIUIN",
    "paymentID": "AAAA009002-1234567890139-RIUIN",
    "type": "ACH",
    "amount": 125.92,
    "currency": {
      "name": "USD",
      "description": "US Dollar",
      "symbol": "$"
    },
    "status": {
      "id": 1,
      "message": "PENDING",
      "updated": "2022-12-11T22:28:21.810Z"
    },
    "userDetails": {
      "userID": "123e4567-e89b-12d3-a456-000000000004",
      "username": "ttc.user.john",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.doe@example.com",
      "parentIBID": {
        "id": "123e4567-e89b-12d3-a456-000000000005",
        "name": "Tendies Trading Company"
      },
      "wlpID": "TTC",
      "settlementProfileID": "settlement-profile-bank-account-1"
    },
    "accountDetails": {
      "accountID": "123e4567-e89b-12d3-a456-000000000004.1234567890125",
      "accountNo": "FFFF000005",
      "accountType": {
        "name": "LIVE",
        "description": "Live Account"
      },
      "accountManagementType": {
        "name": "SELF",
        "description": "Self Directed Account"
      }
    },
    "fees": [
      {
        "type": "FEE_STATE_TAX_CA",
        "description": "Fee - ACH",
        "amount": -5.99,
        "wlpFinTranTypeID": "123e4567-e89b-12d3-a456-00000000004c",
        "transactionCode": "FEE_STATE_TAX_CA",
        "finTranReference": "HG.123e4567-e89b-12d3-a456-00000000004e",
        "created": "2022-12-11T22:28:21.810Z",
        "currency": "USD",
        "symbol": "$"
      }
    ],
    "wlpFinTranTypeID": "123e4567-e89b-12d3-a456-00000000004c",
    "transactionCode": {
      "type": "CSR",
      "description": "Cash Receipt - ACH"
    },
    "iraDistribution": "EARLY_DISTRIBUTION_PENALTY_EXCEPTION",
    "iraDistributionSubType": "SUBSTANTIALLY_EQUAL_PERIODIC_PAYMENTS_SEPP_72T"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.