List all user accounts

GET

accounts

curl --request GET \
  --url https://api.bluum.finance/v1/accounts \
  --header 'Authorization: Basic <encoded-value>'

[
  {
    "id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
    "account_number": "968430933",
    "status": "SUBMITTED",
    "crypto_status": "INACTIVE",
    "currency": "USD",
    "last_equity": "0",
    "created_at": "2025-10-18T01:08:46.263583Z",
    "contact": {
      "email_address": "[email protected]",
      "phone_number": "+15555555555",
      "street_address": [
        "123 Main St"
      ],
      "local_street_address": null,
      "city": "Berkeley",
      "state": "CA",
      "postal_code": "94704",
      "country": "USA"
    },
    "identity": {
      "first_name": "Tosin",
      "last_name": "Oladok",
      "date_of_birth": "1980-01-01",
      "country_of_citizenship": "NGA",
      "country_of_birth": "NGA",
      "party_type": "natural_person",
      "tax_id_type": "USA_SSN",
      "country_of_tax_residence": "NGA",
      "funding_source": [
        "employment_income"
      ]
    },
    "disclosures": {
      "is_control_person": false,
      "is_affiliated_exchange_or_finra": false,
      "is_affiliated_exchange_or_iiroc": null,
      "is_politically_exposed": false,
      "immediate_family_exposed": false,
      "is_discretionary": false
    },
    "agreements": [
      {
        "agreement": "account_agreement",
        "signed_at": "2025-10-17T18:00:00Z",
        "ip_address": "127.0.0.1",
        "revision": "16.2021.05",
        "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"
      }
    ],
    "account_type": "trading",
    "trading_type": "margin",
    "trading_configurations": null,
    "enabled_assets": [
      "us_equity"
    ]
  }
]

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

string<uuid>

Unique identifier for the account.

Example:

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

account_number

string

The actual brokerage account number.

Example:

"968430933"

status

enum<string>

Current status of the account.

Available options:

SUBMITTED,

ACTIVE,

PENDING_APPROVAL,

CLOSED,

SUSPENDED

Example:

"SUBMITTED"

crypto_status

enum<string>

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

Show child attributes

contact.email_address

string<email>

Primary email address for account communications.

Example:

"[email protected]"

contact.phone_number

string

Primary phone number (format may vary by country).

Example:

"+15555555555"

contact.street_address

string[]

Street address lines (supports multiple lines).

Example:

["123 Main St"]

contact.local_street_address

string | null

Localized street address if different from primary address.

Example:

null

contact.city

string

City name.

Example:

"Berkeley"

contact.state

string

State or province code (format varies by country).

Example:

"CA"

contact.postal_code

string

Postal or ZIP code (format varies by country).

Example:

"94704"

contact.country

string

Country code (format varies by country).

Example:

"USA"

identity

object

Show child attributes

identity.first_name

string

First name of the account holder.

Example:

"Tosin"

identity.last_name

string

Last name of the account holder.

Example:

"Oladok"

identity.date_of_birth

string<date>

Date of birth in YYYY-MM-DD format.

Example:

"1980-01-01"

identity.country_of_citizenship

string

ISO country code for citizenship (format varies by country).

Example:

"NGA"

identity.country_of_birth

string

ISO country code for country of birth (format varies by country).

Example:

"NGA"

identity.party_type

enum<string>

Type of party (individual or entity).

Available options:

natural_person,

legal_entity

Example:

"natural_person"

identity.tax_id_type

enum<string>

Type of tax identification number.

Available options:

USA_SSN,

USA_EIN,

CAN_SIN,

GBR_NINO,

AUS_TFN

Example:

"USA_SSN"

identity.country_of_tax_residence

string

ISO country code for tax residence (format varies by country).

Example:

"NGA"

identity.funding_source

enum<string>[]

Primary sources of funding for the account.

Available options:

employment_income,

business_income,

investment_income,

inheritance,

gift,

other

Example:

["employment_income"]

disclosures

object

Show child attributes

disclosures.is_control_person

boolean

Whether the person is a control person of a public company.

Example:

false

disclosures.is_affiliated_exchange_or_finra

boolean

Whether affiliated with an exchange or FINRA member.

Example:

false

disclosures.is_affiliated_exchange_or_iiroc

boolean | null

Whether affiliated with an exchange or IIROC member.

Example:

null

disclosures.is_politically_exposed

boolean

Whether the person is politically exposed.

Example:

false

disclosures.immediate_family_exposed

boolean

Whether immediate family members are politically exposed.

Example:

false

disclosures.is_discretionary

boolean

Whether the account has discretionary trading authority.

Example:

false

agreements

object[]

Legal agreements signed by the account holder.

Show child attributes

agreements.agreement

enum<string>

Type of agreement signed.

Available options:

account_agreement,

customer_agreement,

margin_agreement,

options_agreement,

privacy_policy

Example:

"account_agreement"

agreements.signed_at

string<date-time>

Timestamp when the agreement was signed.

Example:

"2025-10-17T18:00:00Z"

agreements.ip_address

string<ipv4>

IP address from which the agreement was signed.

Example:

"127.0.0.1"

agreements.revision

string

Version or revision of the agreement.

Example:

"16.2021.05"

agreements.account_id

string<uuid>

Account ID associated with the agreement.

Example:

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

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"]

Create a new investment account

⌘I

List all user accounts

curl --request GET \
  --url https://api.bluum.finance/v1/accounts \
  --header 'Authorization: Basic <encoded-value>'

[
  {
    "id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
    "account_number": "968430933",
    "status": "SUBMITTED",
    "crypto_status": "INACTIVE",
    "currency": "USD",
    "last_equity": "0",
    "created_at": "2025-10-18T01:08:46.263583Z",
    "contact": {
      "email_address": "[email protected]",
      "phone_number": "+15555555555",
      "street_address": [
        "123 Main St"
      ],
      "local_street_address": null,
      "city": "Berkeley",
      "state": "CA",
      "postal_code": "94704",
      "country": "USA"
    },
    "identity": {
      "first_name": "Tosin",
      "last_name": "Oladok",
      "date_of_birth": "1980-01-01",
      "country_of_citizenship": "NGA",
      "country_of_birth": "NGA",
      "party_type": "natural_person",
      "tax_id_type": "USA_SSN",
      "country_of_tax_residence": "NGA",
      "funding_source": [
        "employment_income"
      ]
    },
    "disclosures": {
      "is_control_person": false,
      "is_affiliated_exchange_or_finra": false,
      "is_affiliated_exchange_or_iiroc": null,
      "is_politically_exposed": false,
      "immediate_family_exposed": false,
      "is_discretionary": false
    },
    "agreements": [
      {
        "agreement": "account_agreement",
        "signed_at": "2025-10-17T18:00:00Z",
        "ip_address": "127.0.0.1",
        "revision": "16.2021.05",
        "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"
      }
    ],
    "account_type": "trading",
    "trading_type": "margin",
    "trading_configurations": null,
    "enabled_assets": [
      "us_equity"
    ]
  }
]

Overview

Endpoints

Authorizations

Response