Skip to main content
GET
/
investors
List all investors for the authenticated tenant
curl --request GET \
  --url https://api.bluumfinance.com/v1/investors \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "list",
  "url": "/v1/investors",
  "has_more": false,
  "data": [
    {
      "id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "object": "investor",
      "created": 1747776000,
      "livemode": false,
      "metadata": {},
      "status": "active",
      "account_type": "individual",
      "management_type": "self_directed",
      "tax_advantaged": false,
      "tax_designation": null,
      "account_number": "968430933",
      "currency": "USD",
      "balance": "1000.00",
      "buying_power": "10000.00",
      "cash_withdrawable": "5000.00",
      "last_equity": "5000.00",
      "crypto_status": null,
      "trading_type": "cash",
      "first_name": "John",
      "middle_name": null,
      "last_name": "Doe",
      "date_of_birth": "1980-01-01",
      "email": "john.doe@example.com",
      "phone": "+15555555555",
      "address": {
        "street": [
          "123 Main St"
        ],
        "unit": null,
        "city": "Berkeley",
        "state": "CA",
        "postal_code": "94704",
        "country": "US"
      },
      "tax_id_type": "SSN",
      "country_of_tax_residence": "US",
      "country_of_citizenship": "US",
      "country_of_birth": "US",
      "funding_source": [
        "employment_income"
      ],
      "is_control_person": false,
      "is_affiliated_exchange_or_finra": false,
      "is_affiliated_exchange_or_iiroc": null,
      "is_politically_exposed": false,
      "immediate_family_exposed": false,
      "employment_status": "employed",
      "employer_name": "Acme Inc",
      "employer_address": "1 Tech Way, Berkeley, CA",
      "employment_position": "Engineer",
      "signed_agreements": [
        {
          "type": "investor_agreement",
          "signed_at": "2026-01-15T10:30:00.000Z",
          "ip_address": "203.0.113.42"
        }
      ],
      "trusted_contact": null,
      "portfolios": []
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:50

Maximum number of investors to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of investors to skip for pagination.

Required range: x >= 0

Response

List of investors.

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