Get all holdings Run in API Explorer
Ask AI
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/{subAccount}' \
--header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
"data": [
{
"uuid": "9de8a78a-44ba-4faf-bf9f-7af6f8bb56b3",
"created_at": "2026-10-09T09:54:33+01:00",
"updated_at": "2026-10-09T09:54:33+01:00",
"fund_name": "Fund",
"reference": "REF123",
"sector": "Europe",
"sedol": "ACB123",
"isin": "ACB123",
"citi": "ACB123",
"units": 5,
"unit_price": {
"amount": {
"example": "1000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"formatted": {
"example": "£10.00",
"description": "Money amount formatted with currency"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
}
},
"unit_price_raw": 10,
"purchase_price": {
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
}
},
"is_active": true,
"value": {
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
}
},
"sub_account": {
"uuid": "cfd47bda-6e96-4ad6-a779-b34a3bfa2028",
"created_at": "2026-10-09T09:54:33+01:00",
"updated_at": "2026-10-09T09:54:33+01:00",
"name": "John's ISA",
"policy_number": "AVI-4837",
"latest_valuation": {
"uuid": "1d56fcad-5159-4e7b-a9bb-e2b43018b38a",
"created_at": "2026-10-09T09:54:38+01:00",
"updated_at": "2026-10-09T09:54:38+01:00",
"valued_at": "2026-10-09T09:54:38+01:00",
"value": {
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
},
"currency": {
"example": null,
"description": "Currency of the money"
}
}
},
"is_main_account": false,
"active_portfolio": {
"uuid": "7aed28b5-0808-410b-94ec-f5bb7d61020b",
"created_at": "2026-10-09T09:54:38+01:00",
"updated_at": "2026-10-09T09:54:38+01:00",
"is_proposed": true,
"proposed_at": "2026-10-09T00:00:00+01:00",
"name": "Risky Portfolio"
},
"statistics": {
"recent_growth": 100
}
},
"external_references": {
"uuid": "85d67939-0e5d-49d4-b710-e887eb3ab630",
"created_at": "2026-10-09T09:54:33+01:00",
"updated_at": "2026-10-09T09:54:33+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
}
]
}