Create a new investment account

POST

accounts

curl --request POST \
  --url https://api.bluum.finance/v1/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_type": "trading",
  "contact": {
    "email_address": "[email protected]",
    "phone_number": "+15555555555",
    "street_address": [
      "123 Main St"
    ],
    "city": "Berkeley",
    "state": "CA",
    "postal_code": "94704",
    "country": "USA"
  },
  "identity": {
    "first_name": "Tosin",
    "last_name": "Oladok",
    "date_of_birth": "1980-01-01",
    "tax_id": "123-45-6781",
    "tax_id_type": "USA_SSN",
    "country_of_citizenship": "NGA",
    "country_of_birth": "NGA",
    "country_of_tax_residence": "NGA",
    "funding_source": [
      "employment_income"
    ]
  },
  "disclosures": {
    "is_control_person": false,
    "is_affiliated_exchange_or_finra": false,
    "is_politically_exposed": false,
    "immediate_family_exposed": false
  },
  "agreements": [
    {
      "agreement": "account_agreement",
      "agreed": true,
      "signed_at": "2025-10-17T18:00:00Z",
      "ip_address": "127.0.0.1"
    }
  ]
}
'

{
  "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.

Body

application/json

account_type

enum<string>

required

The type of investment account to open.

Available options:

trading,

individual,

joint,

ira,

corporate

Example:

"trading"

contact

object

required

Show child attributes

contact.email_address

string<email>

required

Primary email address for account communications.

Example:

"[email protected]"

contact.phone_number

string

required

Primary phone number (format may vary by country).

Example:

"+15555555555"

contact.street_address

string[]

required

Street address lines (supports multiple lines).

Example:

["123 Main St"]

contact.city

string

required

City name.

Example:

"Berkeley"

contact.state

string

required

State or province code (format varies by country).

Example:

"CA"

contact.postal_code

string

required

Postal or ZIP code (format varies by country).

Example:

"94704"

contact.country

string

required

Country code (format varies by country).

Example:

"USA"

identity

object

required

Show child attributes

identity.first_name

string

required

First name of the account holder.

Example:

"Tosin"

identity.last_name

string

required

Last name of the account holder.

Example:

"Oladok"

identity.date_of_birth

string<date>

required

Date of birth in YYYY-MM-DD format.

Example:

"1980-01-01"

identity.tax_id

string

required

Tax identification number (format varies by country).

Example:

"123-45-6781"

identity.tax_id_type

enum<string>

required

Type of tax identification number.

Available options:

USA_SSN,

USA_EIN,

CAN_SIN,

GBR_NINO,

AUS_TFN

Example:

"USA_SSN"

identity.country_of_citizenship

string

required

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

Example:

"NGA"

identity.country_of_birth

string

required

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

Example:

"NGA"

identity.country_of_tax_residence

string

required

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

Regulatory disclosures and compliance information.

Show child attributes

disclosures.is_control_person

boolean

default:false

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

disclosures.is_affiliated_exchange_or_finra

boolean

default:false

Whether affiliated with an exchange or FINRA member.

disclosures.is_politically_exposed

boolean

default:false

Whether the person is politically exposed.

disclosures.immediate_family_exposed

boolean

default:false

Whether immediate family members are politically exposed.

agreements

object[]

Legal agreements signed by the account holder.

Show child attributes

agreements.agreement

enum<string>

required

Type of agreement signed.

Available options:

account_agreement,

customer_agreement,

margin_agreement,

options_agreement,

privacy_policy

Example:

"account_agreement"

agreements.agreed

boolean

required

Whether the user agreed to the terms.

Example:

true

agreements.signed_at

string<date-time>

required

Timestamp when the agreement was signed.

Example:

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

agreements.ip_address

string<ipv4>

required

IP address from which the agreement was signed.

Example:

"127.0.0.1"

Response

Account successfully created and is pending approval

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

Retrieve a specific account

⌘I

Create a new investment account

curl --request POST \
  --url https://api.bluum.finance/v1/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_type": "trading",
  "contact": {
    "email_address": "[email protected]",
    "phone_number": "+15555555555",
    "street_address": [
      "123 Main St"
    ],
    "city": "Berkeley",
    "state": "CA",
    "postal_code": "94704",
    "country": "USA"
  },
  "identity": {
    "first_name": "Tosin",
    "last_name": "Oladok",
    "date_of_birth": "1980-01-01",
    "tax_id": "123-45-6781",
    "tax_id_type": "USA_SSN",
    "country_of_citizenship": "NGA",
    "country_of_birth": "NGA",
    "country_of_tax_residence": "NGA",
    "funding_source": [
      "employment_income"
    ]
  },
  "disclosures": {
    "is_control_person": false,
    "is_affiliated_exchange_or_finra": false,
    "is_politically_exposed": false,
    "immediate_family_exposed": false
  },
  "agreements": [
    {
      "agreement": "account_agreement",
      "agreed": true,
      "signed_at": "2025-10-17T18:00:00Z",
      "ip_address": "127.0.0.1"
    }
  ]
}
'

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

Body

Response