Get all holdings

GET /api/v1/plans/{plan_uuid}/holdings/{subAccount}

Path parameters

Query parameters

  • include string

    Comma separated list of relationships to include in the response. Valid relationships are [sub_account, portfolio].

  • filter[uuid] string

    Filter by a comma separated list of UUIDs.

  • filter[is_active] boolean

    Filter holdings to only active or only inactive holdings. Defaults to true.

  • filter[portfolio_uuid] string

    Filter holdings by a given portfolio_uuid. Defaults to showing holdings from the active portfolio or all holdings.

  • sort string

    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'.

  • 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]

      Additional properties are allowed.
GET /api/v1/plans/{plan_uuid}/holdings/{subAccount} 
curl \
 -X GET https://api.plannrcrm.com/api/v1/plans/plan_uuid/holdings/subAccount \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json"
Response examples (200) 
{
  "data": [
    {
      "citi": "ACB123",
      "isin": "ACB123",
      "uuid": "4c292da7-eaae-4b41-b27c-72a0d24d5f1f",
      "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-01-17T11:18:31+00: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-01-17T11:18:31+00:00",
      "sub_account": {
        "name": "John's ISA",
        "uuid": "4ee1a220-7bfa-4433-8c59-19d1fedbad4d",
        "created_at": "2025-01-17T11:18:31+00:00",
        "statistics": {
          "recent_growth": 100
        },
        "updated_at": "2025-01-17T11:18:31+00: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": "26476cda-93a1-481c-9ffb-d183c3c140b3",
        "reference": "AB123456",
        "created_at": "2025-01-17T11:18:31+00:00",
        "updated_at": "2025-01-17T11:18:31+00:00",
        "third_party": "nucleus"
      }
    }
  ]
}