Skip to main content
GET
/
investors
/
{investor_id}
/
orders
List orders for an investor
curl --request GET \
  --url https://api.bluumfinance.com/v1/investors/{investor_id}/orders \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "list",
  "url": "/v1/investors/inv_…/deposits",
  "has_more": false,
  "data": [
    {
      "object": "investor",
      "livemode": false,
      "id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "created": 1747776000,
      "metadata": {},
      "investor_id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "symbol": "AAPL",
      "class": "equity",
      "currency": "USD",
      "quantity": "5",
      "notional": "1000.00",
      "limit_price": "<string>",
      "stop_price": "<string>",
      "trail_percent": "<string>",
      "trail_price": "<string>",
      "extended_hours": true,
      "client_order_id": "<string>",
      "status": "pending",
      "filled_quantity": "0",
      "remaining_quantity": "5",
      "average_price": "<string>",
      "commission": "<string>",
      "submitted_at": "2023-11-07T05:31:56Z",
      "filled_at": "2023-11-07T05:31:56Z",
      "cancelled_at": "2023-11-07T05:31:56Z",
      "failure_reason": "<string>",
      "settlement_date": "2026-05-22",
      "bond": {
        "clean_price": "99.875",
        "dirty_price": "100.342",
        "accrued_interest": "0.467",
        "face_value": "10000",
        "yield_at_execution": "0.0475"
      }
    }
  ]
}

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

​
status
enum<string>

Filter orders by status. Use 'open' to retrieve all orders that are pending, submitted, or otherwise not yet in a terminal state.

Available options:
open,
pending,
filled,
partial,
cancelled,
failed
​
symbol
string
​
side
enum<string>
Available options:
buy,
sell
​
class
string

Filter orders by asset class name (case-insensitive). Common values: equity, bond, etf.

​
limit
integer
Required range: 1 <= x <= 100
​
offset
integer
Required range: x >= 0

Response

List of orders.

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