Skip to main content
GET
/
accounts
/
{account_id}
/
withdrawals
List withdrawals for an account
curl --request GET \
  --url https://api.bluumfinance.com/v1/accounts/{account_id}/withdrawals \
  --header 'Authorization: Basic <encoded-value>'
{
  "withdrawals": [
    {
      "withdrawal_id": "wdr_a1b2c3d4e5f6g7h8",
      "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
      "wallet_id": "wal_x1y2z3a4b5c6d7e8",
      "method": "ach_plaid",
      "status": "processing",
      "amount": "500.00",
      "currency": "USD",
      "description": "Monthly payout",
      "method_details": {
        "plaidTransferId": "trf_xyz789",
        "plaidAccountId": "acc_abc123"
      },
      "destination_details": {
        "bankName": "Chase Bank",
        "accountMask": "****5678"
      },
      "initiated_at": "2026-01-17T09:00:00.000Z",
      "submitted_at": "2026-01-17T10:00:00.000Z",
      "completed_at": "2026-01-18T12:00:00.000Z",
      "failure_reason": "Invalid bank account",
      "created_at": "2026-01-17T08:00:00.000Z"
    }
  ],
  "total": 5
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

​
account_id
string<uuid>
required

The unique identifier of the investor account.

Query Parameters

​
method
enum<string>

Filter withdrawals by method.

Available options:
ach_plaid,
wire
​
status
enum<string>

Filter withdrawals by status.

Available options:
pending,
processing,
submitted,
completed,
canceled,
failed
​
currency
string

Filter withdrawals by currency (3-letter ISO code).

Required string length: 3
​
date_from
string

Filter withdrawals from this date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
date_to
string

Filter withdrawals to this date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
limit
integer
default:50

Maximum number of withdrawals to return.

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of withdrawals to skip for pagination.

Required range: x >= 0

Response

List of withdrawals for the account

​
withdrawals
object[]
​
total
integer

Total number of withdrawals matching the filter criteria.

Example:

5