Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
investment-policy
Get investment policy statement
curl --request GET \
  --url https://api.bluumfinance.com/v1/wealth/accounts/{account_id}/investment-policy \
  --header 'Authorization: Basic <encoded-value>'
{
  "ips_id": "ips_a1b2c3d4e5f6",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "version": 3,
  "risk_profile": {
    "risk_tolerance": "moderate",
    "risk_score": 6
  },
  "time_horizon": {
    "years": 15,
    "category": "long_term"
  },
  "investment_objectives": {
    "primary": "capital_appreciation",
    "secondary": [
      "income_generation"
    ]
  },
  "target_allocation": {
    "equities": {
      "target_percent": "50.00",
      "min_percent": "40.00",
      "max_percent": "60.00"
    },
    "fixed_income": {
      "target_percent": "25.00",
      "min_percent": "20.00",
      "max_percent": "30.00"
    },
    "treasury": {
      "target_percent": "20.00",
      "min_percent": "15.00",
      "max_percent": "25.00"
    },
    "alternatives": {
      "target_percent": "5.00",
      "min_percent": "0.00",
      "max_percent": "10.00"
    }
  },
  "constraints": {
    "rebalancing_policy": {
      "frequency": "quarterly",
      "threshold_percent": "5.00"
    }
  },
  "effective_date": "2025-01-15",
  "status": "active",
  "created_at": "2023-01-01T10:00:00Z",
  "updated_at": "2025-01-15T10:00:00Z",
  "version_history": [
    {
      "version": 1,
      "effective_date": "2023-01-01",
      "updated_at": "2023-01-01T10:00:00Z"
    },
    {
      "version": 2,
      "effective_date": "2024-01-01",
      "updated_at": "2024-01-01T10:00:00Z"
    },
    {
      "version": 3,
      "effective_date": "2025-01-15",
      "updated_at": "2025-01-15T10:00:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
account_id
string<uuid>
required

The investor account ID

Query Parameters

​
version
integer

Get specific version (default is latest active)

Required range: x >= 1
​
include_history
boolean
default:false

Include version history

Response

Investment policy statement retrieved successfully

Investment policy statement defining risk profile, objectives, and constraints

​
ips_id
string<uuid>
​
account_id
string<uuid>
​
version
integer

Version number (versioned, immutable once published)

​
risk_profile
object
​
time_horizon
object
​
investment_objectives
object
​
target_allocation
object

Target asset allocation with min/max bands

Example:
{
  "equities": {
    "target_percent": "50.00",
    "min_percent": "40.00",
    "max_percent": "60.00"
  },
  "fixed_income": {
    "target_percent": "25.00",
    "min_percent": "20.00",
    "max_percent": "30.00"
  },
  "treasury": {
    "target_percent": "20.00",
    "min_percent": "15.00",
    "max_percent": "25.00"
  },
  "alternatives": {
    "target_percent": "5.00",
    "min_percent": "0.00",
    "max_percent": "10.00"
  }
}
​
constraints
object

Investment constraints and guidelines

​
effective_date
string<date>
​
status
enum<string>
Available options:
draft,
active,
superseded
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
version_history
object[]