Skip to main content
GET
/
wallet
/
accounts
/
{account_id}
/
transactions
List transactions for an account
curl --request GET \
  --url https://api.bluum.finance/v1/wallet/accounts/{account_id}/transactions \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "transaction_id": "txn_a1b2c3d4e5f6g7h8",
    "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
    "type": "deposit",
    "status": "pending",
    "amount": "5000.00",
    "currency": "USD",
    "funding_type": "fiat",
    "funding_details": {},
    "description": "Initial account funding",
    "external_reference_id": "ref_12345",
    "fee": "0.00",
    "net_amount": "5000.00",
    "created_at": "2025-10-18T10:30:00Z",
    "settled_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
Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

Query Parameters

​
type
enum<string>

Filter transactions by type.

Available options:
deposit,
withdrawal
​
status
enum<string>

Filter transactions by status.

Available options:
pending,
processing,
settled,
failed,
canceled
​
funding_type
enum<string>

Filter transactions by funding type.

Available options:
fiat,
crypto
​
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

​
transaction_id
string<uuid>

Unique identifier for the transaction.

Example:

"txn_a1b2c3d4e5f6g7h8"

​
account_id
string<uuid>

Account ID associated with the transaction.

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

​
type
enum<string>

Type of transaction.

Available options:
deposit,
withdrawal
Example:

"deposit"

​
status
enum<string>

Current status of the transaction.

Available options:
pending,
processing,
settled,
failed,
canceled
Example:

"pending"

​
amount
string

Transaction amount.

Example:

"5000.00"

​
currency
string

Currency of the transaction.

Example:

"USD"

​
funding_type
enum<string>

Type of funding used.

Available options:
fiat,
crypto
Example:

"fiat"

​
funding_details
object

Details of the funding method used.

​
description
string

Description of the transaction.

Example:

"Initial account funding"

​
external_reference_id
string

External reference ID for client tracking.

Example:

"ref_12345"

​
fee
string

Fee charged for the transaction.

Example:

"0.00"

​
net_amount
string

Net amount after fees.

Example:

"5000.00"

​
created_at
string<date-time>

Timestamp when the transaction was created.

Example:

"2025-10-18T10:30:00Z"

​
settled_at
string<date-time> | null

Timestamp when the transaction was settled.

Example:

null

​
failed_at
string<date-time> | null

Timestamp when the transaction failed.

Example:

null

​
failure_reason
string | null

Reason for transaction failure if applicable.

Example:

null