GET /api/v1/plans/{plan_uuid}/sub-accounts
Personal access token & O auth2

Path parameters

  • plan_uuid string Required

Query parameters

  • include string

    Comma separated list of relationships to include in the response. Valid relationships are [latest_valuation].

  • filter[uuid] string

    Filter by a comma separated list of UUIDs.

  • sort string

    Field to sort by. Valid fields are [created_at, name]. Negative sign to denote DESC. Defaults to 'name'.

  • per_page integer

    Number of results to return with pagination (Default 15. Max 500).

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • data array[object]
      Hide data attributes Show data attributes object
      • uuid string

        UUID of the sub account

      • created_at string

        The timestamp of when the resource was created.

      • updated_at string

        The timestamp of when the resource was created.

      • name string

        Descriptive name of the sub account

      • policy_number string

        Provider reference of the sub account

      • latest_valuation object

        The latest valuation of the sub account

        Hide latest_valuation attributes Show latest_valuation attributes object
        • uuid string
        • created_at string
        • updated_at string
        • valued_at string
        • value object
          Hide value attributes Show value attributes object
          • amount object
            Hide amount attributes Show amount attributes object
            • example string
            • description string
          • formatted object
            Hide formatted attributes Show formatted attributes object
            • example string
            • description string
          • currency object
            Hide currency attributes Show currency attributes object
            • example string
            • description string
        • sub_account string
      • is_main_account boolean

        Denotes if the sub account a main account of the plan

      • active_portfolio object

        The active portfolio of the sub account

        Hide active_portfolio attributes Show active_portfolio attributes object
        • uuid string
        • created_at string
        • updated_at string
        • is_proposed boolean
        • proposed_at string
        • name string
      • statistics object

        The statistics on a sub account. Only displayed when you retrieve an individual sub-account.

        Hide statistics attribute Show statistics attribute object
        • recent_growth integer
GET /api/v1/plans/{plan_uuid}/sub-accounts 
curl \
 --request GET 'https://api.plannrcrm.com/api/v1/plans/6ff8f7f6-1eb3-3525-be4a-3932c805afed/sub-accounts' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": [
    {
      "uuid": "0352f182-d098-4f76-af78-c685a75332df",
      "created_at": "2026-04-28T22:34:36+01:00",
      "updated_at": "2026-04-28T22:34:36+01:00",
      "name": "John's ISA",
      "policy_number": "AVI-4837",
      "latest_valuation": {
        "uuid": "d3ee29f9-f142-4cbd-8b5c-9012df8a7953",
        "created_at": "2026-04-28T22:34:36+01:00",
        "updated_at": "2026-04-28T22:34:36+01:00",
        "valued_at": "2026-04-28T22:34:36+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": "GBP",
            "description": "Currency of the money"
          }
        },
        "sub_account": "App\\Http\\Resources\\Plans\\SubAccountResource"
      },
      "is_main_account": false,
      "active_portfolio": {
        "uuid": "4617c888-36f5-4266-92aa-b8d04b1a3042",
        "created_at": "2026-04-28T22:34:36+01:00",
        "updated_at": "2026-04-28T22:34:36+01:00",
        "is_proposed": true,
        "proposed_at": "2026-04-28T00:00:00+01:00",
        "name": "Risky Portfolio"
      },
      "statistics": {
        "recent_growth": 100
      }
    }
  ]
}