---
title: "How do I generate a holdings report?"
slug: "how-do-i-generate-a-holdings-report"
updated: 2025-06-16T10:23:59Z
published: 2025-06-16T10:23:59Z
canonical: "support.lusid.com/how-do-i-generate-a-holdings-report"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I generate a holdings report?

You can generate a holdings report for a [transaction portfolio](/v1/docs/how-do-i-create-a-transaction-portfolio) at any time.

## Using the LUSID web app

1. Navigate to the **Portfolio Management > Holdings** dashboard.
2. Choose a portfolio or portfolio group and optionally an effective date (defaults to today): ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(887).png)

## Using Luminesce

You can use the [Lusid.Portfolio.Holding](/v1/docs/lusidportfolioholding) provider.

## Using the LUSID REST API

Call the LUSID [GetHoldings](https://www.lusid.com/docs/api#operation/GetHoldings) API. Note you can decorate instrument as well as holdings properties onto the response using the `propertyKeys` parameter, and it's almost always useful to retrieve the `Instrument/default/Name` system property in order to meaningfully identify results. Note also the request is effective today unless you specify a historical date using the `effectiveAt` parameter. For example:

```json
curl -X GET "https://<your-domain>.lusid.com/api/api/transactionportfolios/Finbourne-Examples/UK-Equities/holdings?propertyKeys=Instrument%2Fdefault%2FName"
   -H "Authorization: Bearer <your-API-access-token>"
```

If the request is successful, the response contains one value per holding, for example:

```json
"values": [
    {
      "instrumentScope": "default",
      "instrumentUid": "LUID_WPFIPFGD",
      "subHoldingKeys": {},
      "properties": {
        "Instrument/default/Name": {
          "key": "Instrument/default/Name",
          "value": {
            "labelValue": "LEGAL&GEN."
          },
          "effectiveFrom": "0001-01-01T00:00:00.0000000+00:00"
        },
        "Holding/default/SourcePortfolioId": {
          "key": "Holding/default/SourcePortfolioId",
          "value": {
            "labelValue": "UK-Equities"
          },
          "effectiveFrom": "0001-01-01T00:00:00.0000000+00:00"
        },
        "Holding/default/SourcePortfolioScope": {
          "key": "Holding/default/SourcePortfolioScope",
          "value": {
            "labelValue": "Finbourne-Examples"
          },
          "effectiveFrom": "0001-01-01T00:00:00.0000000+00:00"
        }
      },
      "holdingType": "P",
      "units": 82867.64705882352,
      "settledUnits": 82867.64705882352,
      "cost": {
        "amount": 238244.49,
        "currency": "GBP"
      },
      "costPortfolioCcy": {
        "amount": 238244.49,
        "currency": "GBP"
      },
      "currency": "GBP"
    },
    ...
]
```

##