Skip to main content
GET
/
investors
/
{investor_id}
/
transactions
List transactions for an investor
curl --request GET \
  --url https://api.bluumfinance.com/v1/investors/{investor_id}/transactions \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "list",
  "url": "/v1/investors/inv_01j9x8m2k7qpzwv3t5r6y8n0ab/transactions",
  "has_more": false,
  "data": [
    {
      "id": "txn_01j9x8m2k7qpzwv3t5r6y8n0gh",
      "object": "transaction",
      "created": 1747776000,
      "livemode": false,
      "metadata": {},
      "investor_id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "wallet_id": "wlt_01j9x8m2k7qpzwv3t5r6y8n0cd",
      "type": "deposit",
      "status": "completed",
      "amount": "5000.00",
      "currency": "USD",
      "method": "ach",
      "description": "Initial account funding",
      "completed_at": "2026-01-16T14:20:00Z",
      "failed_at": null,
      "failure_reason": null
    },
    {
      "id": "txn_01j9x8m2k7qpzwv3t5r6y8n0ij",
      "object": "transaction",
      "created": 1747780000,
      "livemode": false,
      "metadata": {},
      "investor_id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "wallet_id": "wlt_01j9x8m2k7qpzwv3t5r6y8n0cd",
      "type": "withdrawal",
      "status": "pending",
      "amount": "1000.00",
      "currency": "USD",
      "method": "ach",
      "description": "Withdrawal to bank account",
      "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

​
investor_id
string
required

Prefixed public id of the investor (e.g. inv_…).

Query Parameters

​
type
enum<string>

Filter by transaction kind (funding, trade cash movement, or custodian activity)

Available options:
deposit,
withdrawal,
buy,
sell,
activity
​
activity_type
string

Comma-separated activity tags to filter on (e.g. FIMAT,CDIV). Only meaningful when type=activity or type is omitted. Common values: FIMAT (fixed-income maturity), CDIV / SDIV (dividends), DIVNRA (dividend withholding), FEE, INT, JNLC / JNLS (journals), ACATC / ACATS, corporate actions (FSPLIT, RSPLIT, CMA, SMA, REORG, SPIN, VOF).

Example:

"FIMAT,CDIV"

​
status
enum<string>

Filter by deposit/withdrawal status (Bluum-native enum, lowercased in responses)

Available options:
pending,
processing,
received,
completed,
submitted,
expired,
canceled,
failed
​
currency
string
Required string length: 3
Example:

"USD"

​
date_from
string<date>
​
date_to
string<date>
​
limit
integer
default:50
Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0

Response

List of transactions.

List envelope. data holds the page of items; each item is itself wrapped in a ResourceEnvelope.

​
object
enum<string>
required
Available options:
list
​
url
string
required

The endpoint path that produced this list.

Example:

"/v1/investors/inv_…/deposits"

​
has_more
boolean
required

Whether more results exist beyond data.

Example:

false

​
data
object[]
required