Query parameters
-
Comma separated list of relationships to include in the response. Valid relationships are [sub_account, portfolio].
-
Filter by a comma separated list of UUIDs.
-
Filter holdings to only active or only inactive holdings. Defaults to true.
-
Filter holdings by a given portfolio_uuid. Defaults to showing holdings from the active portfolio or all holdings.
-
Field to sort by. Valid fields are [created_at, updated_at, units, unit_price, is_active]. Negative sign to denote DESC. Defaults to '-created_at'.
-
Number of results to return with pagination (Default 15. Max 500).
GET
/api/v1/plans/{plan_uuid}/holdings/{subAccount}
curl \
--request GET 'https://api.plannrcrm.com/api/v1/plans/6ff8f7f6-1eb3-3525-be4a-3932c805afed/holdings/{"value"=>"", "summary"=>"When the value is omitted"}' \
--header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
"data": [
{
"citi": "ACB123",
"isin": "ACB123",
"uuid": "d3a9b78c-86f4-4710-8891-52332c86a8c8",
"sedol": "ACB123",
"units": 5,
"value": {
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
}
},
"sector": "Europe",
"fund_name": "Fund",
"is_active": true,
"reference": "REF123",
"created_at": "2025-06-26T11:37:08+01:00",
"unit_price": {
"amount": {
"example": "1000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
},
"formatted": {
"example": "£10.00",
"description": "Money amount formatted with currency"
}
},
"updated_at": "2025-06-26T11:37:08+01:00",
"sub_account": {
"name": "John's ISA",
"uuid": "06adb2dc-49d3-4538-82e7-044c89c32b21",
"created_at": "2025-06-26T11:37:08+01:00",
"statistics": {
"recent_growth": 100
},
"updated_at": "2025-06-26T11:37:08+01:00",
"policy_number": "AVI-4837",
"is_main_account": false,
"active_portfolio": "App\\Http\\Resources\\Plans\\PortfolioResource",
"latest_valuation": "App\\Http\\Resources\\Plans\\ValuationResource"
},
"purchase_price": {
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
}
},
"unit_price_raw": 10,
"external_references": {
"uuid": "47a261a5-ab34-4afd-8cfc-807fcb9148d2",
"reference": "AB123456",
"created_at": "2025-06-26T11:37:08+01:00",
"updated_at": "2025-06-26T11:37:08+01:00",
"third_party": "nucleus"
}
}
]
}