Skip to main content
GET
/
accounts
/
{account_id}
/
transactions
List transactions for an account
curl --request GET \
  --url https://api.bluumfinance.com/v1/accounts/{account_id}/transactions \
  --header 'Authorization: Basic <encoded-value>'
{
  "transactions": [
    {
      "transaction_id": "dep_a1b2c3d4e5f6",
      "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
      "wallet_id": "w_a1b2c3d4e5f6",
      "type": "deposit",
      "status": "completed",
      "amount": "5000.00",
      "currency": "USD",
      "method": "ach_plaid",
      "description": "Initial account funding",
      "created_at": "2025-01-15T10:30:00Z",
      "completed_at": "2025-01-16T14:20:00Z",
      "failed_at": null,
      "failure_reason": null
    },
    {
      "transaction_id": "wd_b2c3d4e5f6g7",
      "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
      "wallet_id": "w_a1b2c3d4e5f6",
      "type": "withdrawal",
      "status": "pending",
      "amount": "1000.00",
      "currency": "USD",
      "method": "ach_plaid",
      "description": "Withdrawal to bank account",
      "created_at": "2025-01-17T09:15:00Z",
      "completed_at": null,
      "failed_at": null,
      "failure_reason": null
    }
  ]
}

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 account

Query Parameters

type
enum<string>

Filter transactions by type

Available options:
deposit,
withdrawal
status
enum<string>

Filter transactions by status

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

Filter transactions by currency (3-letter ISO code)

Required string length: 3
Example:

"USD"

date_from
string<date>

Filter transactions from this date (YYYY-MM-DD)

date_to
string<date>

Filter transactions to this date (YYYY-MM-DD)

limit
integer
default:50

Maximum number of transactions to return

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

Number of transactions to skip for pagination

Required range: x >= 0

Response

List of transactions for the account

transactions
object[]