Skip to main content
GET
/
accounts
/
{account_id}
/
deposits
List deposits for an account
curl --request GET \
  --url https://service.bluumfinance.com/v1/accounts/{account_id}/deposits \
  --header 'Authorization: Basic <encoded-value>'
{
  "deposits": [
    {
      "deposit_id": "dep_a1b2c3d4e5f6g7h8",
      "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
      "wallet_id": "wal_x1y2z3a4b5c6d7e8",
      "method": "manual_bank_transfer",
      "status": "pending",
      "amount": "1000.00",
      "currency": "USD",
      "description": "Initial funding",
      "method_details": {
        "referenceCode": "BLUUM-ABC123XY",
        "bankDetails": {
          "bankName": "Choice Financial Group",
          "bankAddress": "4501 23rd Avenue S Fargo, ND 58104 US",
          "accountName": "Bluum Finance, Inc.",
          "accountNumber": "202534766488",
          "accountKind": "Savings",
          "routingNumber": "091311229",
          "swiftCode": "CHFGUS44021",
          "beneficiaryAddress": "131 Continental Dr, Suite 305 Newark, DE 19713 US",
          "instructions": "Include reference code \"BLUUM-ABC123XY\" in your transfer memo."
        }
      },
      "initiated_at": "2026-01-15T10:00:00.000Z",
      "received_at": "2026-01-16T11:00:00.000Z",
      "completed_at": "2026-01-16T12:00:00.000Z",
      "expires_at": "2026-01-22T10:00:00.000Z",
      "failure_reason": "Insufficient funds",
      "created_at": "2026-01-15T09:00:00.000Z"
    }
  ],
  "total": 10
}

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 deposits by method.

Available options:
ach,
manual_bank_transfer,
wire
​
status
enum<string>

Filter deposits by status.

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

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

Required string length: 3
​
date_from
string

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

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

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

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

Maximum number of deposits to return.

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

Number of deposits to skip for pagination.

Required range: x >= 0

Response

List of deposits for the account

​
deposits
object[]
​
total
integer

Total number of deposits matching the filter criteria.

Example:

10