Skip to main content
GET
/
accounts
List all user accounts
curl --request GET \
  --url https://api.bluumfinance.com/v1/accounts \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
    "account_number": "968430933",
    "status": "ACTIVE",
    "crypto_status": "INACTIVE",
    "currency": "USD",
    "balance": "1000.00",
    "last_equity": "0",
    "created_at": "2025-10-18T01:08:46.263583Z",
    "account_type": "trading",
    "trading_type": "cash",
    "enabled_assets": [
      "us_equity"
    ],
    "contact": {
      "email_address": "john.doe@example.com",
      "phone_number": "+15555555555",
      "street_address": [
        "123 Main St"
      ],
      "city": "Berkeley",
      "state": "CA",
      "postal_code": "94704",
      "country": "USA"
    },
    "identity": {
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "1980-01-01",
      "country_of_citizenship": "USA",
      "country_of_birth": "USA",
      "party_type": "natural_person",
      "tax_id_type": "SSN",
      "country_of_tax_residence": "USA",
      "funding_source": [
        "employment_income"
      ]
    },
    "disclosures": {
      "is_control_person": false,
      "is_affiliated_exchange_or_finra": false,
      "is_politically_exposed": false,
      "immediate_family_exposed": false,
      "is_discretionary": false
    },
    "agreements": []
  }
]

Authorizations

​
Authorization
string
header
required

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

Response

A list of the user's investment accounts

​
id
string<uuid>

Unique identifier for the account.

Example:

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

​
account_number
string | null

The actual brokerage account number.

Example:

"968430933"

​
status
enum<string>

Current status of the account.

Available options:
ACTIVE,
INACTIVE,
SUSPENDED
Example:

"ACTIVE"

​
crypto_status
enum<string> | null

Status of crypto trading capabilities.

Available options:
ACTIVE,
INACTIVE,
SUSPENDED
Example:

"INACTIVE"

​
currency
string

Primary currency of the account.

Example:

"USD"

​
last_equity
string

Last recorded equity value.

Example:

"0"

​
created_at
string<date-time>

Timestamp when the account was created.

Example:

"2025-10-18T01:08:46.263583Z"

​
contact
object
​
identity
object
​
disclosures
object
​
agreements
object[]

Legal agreements signed by the account holder.

​
account_type
enum<string>

The type of investment account.

Available options:
trading,
individual,
joint,
ira,
corporate
Example:

"trading"

​
trading_type
enum<string>

The type of trading account.

Available options:
margin,
cash
Example:

"margin"

​
trading_configurations
object

Trading configuration settings.

Example:

null

​
enabled_assets
enum<string>[]

Asset classes enabled for trading on this account.

Available options:
us_equity,
us_option,
crypto,
bonds,
etf,
mutual_funds
Example:
["us_equity"]