--- updatedAt: 2026-05-27T16:58:23.000Z agentTools: projectIndex: https://developer.drivewealth.com/apis/llms.txt --- # List Account Deposits Retrieves a list of Account Deposits by accountID. # OpenAPI definition ```json { "openapi": "3.0.2", "info": { "title": "Money Movement APIs", "version": "2026-10-08", "contact": { "email": "producteng@drivewealth.tech" } }, "servers": [ { "url": "https://bo-api.drivewealth.io/back-office", "description": "Sandbox (No Real World Financial/Trading Impact)" }, { "url": "https://bo-api.drivewealth.net/back-office", "description": "Production" } ], "security": [ { "bearerAuth": [] } ], "x-readme": { "explorer-enabled": false, "headers": [ { "key": "dw-client-app-key", "value": "{{yourAppKey}}" } ] }, "tags": [ { "name": "Deposits" } ], "paths": { "/accounts/{accountID}/funding/deposits": { "get": { "tags": [ "Deposits" ], "parameters": [ { "in": "path", "name": "accountID", "schema": { "$ref": "#/components/schemas/accountID" }, "required": true }, { "in": "query", "name": "status", "schema": { "type": "string" }, "example": "Successful,Pending", "description": "Comma separated payment statuses" }, { "in": "query", "name": "type", "schema": { "type": "string" }, "example": "ACH,WIRE,BULK_FUNDING", "description": "Comma separated deposit types" }, { "in": "query", "name": "limit", "schema": { "type": "integer", "default": 25 }, "example": 50, "description": "The number of deposits to be returned per page. Minimum=1, Maximum=100" }, { "in": "query", "name": "offset", "schema": { "type": "string" }, "example": "11AA000001-1234567890128-RJJLU", "description": "Should either be null or the last payment result in the previous request" } ], "summary": "List Account Deposits", "description": "Retrieves a list of Account Deposits by accountID.", "responses": { "200": { "description": "Retrieving a list of Account Deposits was Successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/depositsByUserIDObject" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseModel" }, "examples": { "Limit should be greater than 0": { "value": { "errorCode": "E025", "message": "Invalid or badly formatted request. Refer to the API documentation for details. Details: Invalid value: limit. Limit should be greater than 0." } }, "Limit should be less than or equal to 100": { "value": { "errorCode": "E025", "message": "Invalid or badly formatted request. Refer to the API documentation for details. Details: Invalid value: limit. Limit should be less than or equal to 100" } } } } } } } } } }, "components": { "schemas": { "ErrorCode": { "type": "string", "description": "The error code that is returned when an error occurs.", "example": "E032" }, "ErrorCodeMessage": { "type": "string", "description": "The error message that is returned when an error occurs." }, "ErrorDetails": { "type": "object", "properties": { "field": { "type": "string", "description": "JSON field name from the request body that caused an error" }, "type": { "type": "string", "enum": [ "STRING", "ARRAY", "INT", "DECIMAL", "BOOL", "TEXT", "UUID", "DATE", "MAP", "OBJECT", "ENUM" ], "description": "Expected data type of the field", "x-enumDescriptions": { "STRING": "The value is a string.", "ARRAY": "The value is an array.", "INT": "The value is an integer.", "DECIMAL": "The value is a decimal number.", "BOOL": "The value is a boolean.", "TEXT": "The value is free-form text.", "UUID": "The value is a UUID.", "DATE": "The value is a date.", "MAP": "The value is a key-value map.", "OBJECT": "The value is an object.", "ENUM": "The value is one of a fixed set of enumerated values." } }, "allowedValues": { "type": "string", "description": "Example values which are allowed in the field" }, "detail": { "type": "string", "description": "Additional validation or error details for the field" } } }, "ErrorResponseModel": { "type": "object", "description": "The error response model that is returned when an error occurs.", "required": [ "errorCode", "message" ], "properties": { "errorCode": { "$ref": "#/components/schemas/ErrorCode" }, "message": { "$ref": "#/components/schemas/ErrorCodeMessage" }, "errorDetails": { "$ref": "#/components/schemas/ErrorDetails" } } }, "depositID": { "type": "string", "example": "YYYY009000-1234567890136-1A2B3", "description": "A unique identifier for the Deposit." }, "accountID": { "type": "string", "example": "123e4567-e89b-12d3-a456-000000000004.1234567890125", "description": "The user's unique account identifier." }, "accountNo": { "type": "string", "example": "FFFF000005", "description": "The user's unique account number, that is human readable." }, "accountTypeObject": { "type": "object", "properties": { "name": { "type": "string", "example": "LIVE", "description": "The type of account that has been created." }, "description": { "type": "string", "example": "Live Account", "description": "A custom description of the account type." } } }, "accountManagementTypeObject": { "type": "object", "properties": { "name": { "type": "string", "example": "SELF", "description": "The type of account who has trading authority.", "enum": [ "SELF", "ADVISORY", "RIA_MANAGED", "CUSTODIAL", "CUSTODIAL_MANAGED", "RESERVE", "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", "TRUMP_SELF" ], "x-enumDescriptions": { "SELF": "A user directs trades in their own account without advice.", "ADVISORY": "An Investment Advisor or Investment Advisor Representative has access to the account, but trades are placed only with the user's authorization.", "RIA_MANAGED": "An Investment Advisor has discretion to place trades in the account.", "CUSTODIAL": "An account held for the benefit of a minor.", "CUSTODIAL_MANAGED": "A custodial account with discretionary trading managed by an advisor.", "RESERVED": "Reserved for future use; not currently assigned.", "RETIREMENT_TRADITIONAL_SELF": "A self-directed Traditional IRA retirement account.", "RETIREMENT_TRADITIONAL_ADVISORY": "A Traditional IRA retirement account accessible to an advisor, with trades placed only by the user's authorization.", "RETIREMENT_TRADITIONAL_RIA_MANAGED": "A Traditional IRA retirement account with discretionary trading managed by an advisor.", "RETIREMENT_ROTH_SELF": "A self-directed Roth IRA retirement account.", "RETIREMENT_ROTH_ADVISORY": "A Roth IRA retirement account accessible to an advisor, with trades placed only by the user's authorization.", "RETIREMENT_ROTH_RIA_MANAGED": "A Roth IRA retirement account with discretionary trading managed by an advisor.", "TRUST_SELF": "A self-directed Trust account.", "TRUST_ADVISORY": "A Trust account accessible to an advisor, with trades placed only by the user's authorization.", "TRUST_RIA_MANAGED": "A Trust account with discretionary trading managed by an advisor.", "HSA_SELF": "A self-directed Health Savings Account.", "HSA_ADVISORY": "A Health Savings Account accessible to an advisor, with trades placed only by the user's authorization.", "HSA_RIA_MANAGED": "A Health Savings Account with discretionary trading managed by an advisor.", "BUSINESS_SELF": "A self-directed Business account.", "BUSINESS_ADVISORY": "A Business account accessible to an advisor, with trades placed only by the user's authorization.", "BUSINESS_RIA_MANAGED": "A Business account with discretionary trading managed by an advisor.", "TRUMP_SELF": "A self-directed Trump account." } }, "description": { "type": "string", "example": "Self Directed Account", "description": "A custom description of the account management type." } } }, "updated": { "type": "string", "example": "2022-12-11T22:28:21.810Z", "description": "" }, "note": { "type": "string", "example": "Hey! Welcome to DriveWealth Developer Docs!", "description": "A way to store a message/comment on the this object." }, "wlpFinTranTypeID": { "type": "string", "example": "123e4567-e89b-12d3-a456-00000000004c", "description": "A unique identifier to id different type of transactions." }, "depositStatusNumber": { "type": "number", "example": 1, "description": "The current status of the user's deposit in integer form.", "enum": [ 0, 1, 2, 3, 4, 14, 15, 16, 17, 5, -1 ], "x-enumDescriptions": { "0": "Started — a new deposit request was received.", "1": "Pending — the deposit details were accepted.", "2": "Successful — the deposit was successful.", "3": "Failed — the deposit was not successful.", "4": "Other — the deposit is in a suspended state.", "5": "Returned — the deposit was returned to the originating bank.", "14": "Approved — the deposit was approved.", "15": "Rejected — the deposit was rejected.", "16": "On hold — the deposit details were accepted, but it is not yet ready to be processed.", "17": "Processing — the deposit is being processed.", "-1": "An error occurred during the deposit." } }, "depositStatus": { "type": "string", "example": "PENDING", "description": "The current status of the user's deposit.", "enum": [ "STARTED", "PENDING", "PROCESSING", "SUCCESSFUL", "FAILED", "OTHER", "APPROVED", "REJECTED", "ON_HOLD", "PROCESSING", "RETURNED", "-" ], "x-enumDescriptions": { "STARTED": "A new deposit request was received.", "PENDING": "The deposit details were accepted.", "PROCESSING": "The deposit is being processed.", "SUCCESSFUL": "The deposit was successful.", "FAILED": "The deposit was not successful.", "OTHER": "The deposit is in a suspended state.", "APPROVED": "The deposit was approved.", "REJECTED": "The deposit was rejected.", "ON_HOLD": "The deposit details were accepted, but it is not yet ready to be processed.", "RETURNED": "The deposit was returned to the originating bank.", "-": "An error occurred during the deposit." } }, "currency": { "type": "string", "example": "USD", "description": "The name of the currency in abbreviation form.", "enum": [ "USD" ], "x-enumDescriptions": { "USD": "U.S. Dollar." } }, "currencySymbol": { "type": "string", "example": "$", "description": "The currency symbol.", "enum": [ "$" ], "x-enumDescriptions": { "$": "U.S. Dollar symbol." } }, "currencyObject": { "type": "object", "properties": { "name": { "$ref": "#/components/schemas/currency" }, "description": { "type": "string", "example": "US Dollar", "description": "A custom description about the currency." }, "symbol": { "$ref": "#/components/schemas/currencySymbol" } } }, "depositStatusObject": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/depositStatusNumber" }, "message": { "$ref": "#/components/schemas/depositStatus" }, "updated": { "$ref": "#/components/schemas/updated", "description": "The last updated timestamp of the status of the user's deposit." } } }, "depositsByUserIDObject": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/depositID" }, "paymentID": { "$ref": "#/components/schemas/depositID" }, "amount": { "type": "number", "example": 125.22, "description": "The amount of the deposit" }, "currency": { "$ref": "#/components/schemas/currencyObject" }, "status": { "$ref": "#/components/schemas/depositStatusObject" }, "accountDetails": { "type": "object", "properties": { "accountID": { "$ref": "#/components/schemas/accountID" }, "accountNo": { "$ref": "#/components/schemas/accountNo" }, "accountType": { "$ref": "#/components/schemas/accountTypeObject" }, "accountManagementType": { "$ref": "#/components/schemas/accountManagementTypeObject" } } }, "wlpFinTranTypeID": { "$ref": "#/components/schemas/wlpFinTranTypeID" }, "note": { "$ref": "#/components/schemas/note" } } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } } } ``` # Sibling pages * [List User Deposits](https://developer.drivewealth.com/apis/reference/get_users-userid-funding-deposits.md) * [List User Recurring Deposits](https://developer.drivewealth.com/apis/reference/get_users-userid-recurring-deposits.md) * [Create Deposit](https://developer.drivewealth.com/apis/reference/post_funding-deposits.md) * [Retrieve Deposit](https://developer.drivewealth.com/apis/reference/get_funding-deposits-depositid.md) * [Retrieve Recurring Deposits](https://developer.drivewealth.com/apis/reference/get_funding-recurring-deposits-recurringid.md) * [Update Recurring Deposit](https://developer.drivewealth.com/apis/reference/patch_funding-recurring-deposits-recurringid.md) * [Delete Recurring Deposit](https://developer.drivewealth.com/apis/reference/delete_funding-recurring-deposits-recurringid.md) * [Deposit Status](https://developer.drivewealth.com/apis/reference/deposit-status.md) * [List Deposits](https://developer.drivewealth.com/apis/reference/get_funding-deposits.md) * [Update Deposit ACH Settlement](https://developer.drivewealth.com/apis/reference/patch_funding-deposits-depositid-achsettlement.md)