Sub Portfolio Holdings

The subportfolioholdings endpoint returns cash holdings split by sub-portfolio code. The sub-portfolio code provides a level more granularity than the entity-level balances. That is, a sub-portfolio code reflects the cash balances separated by the specific sub-account codes. These codes will differ per currency, and per intention. For example, capital versus income accounts. Requests are made using the entityId parameter, which is mandatory.

For the full list of parameters accepted as well as which are required, see Parameters below. To view Sample response data, expand the menu under Responses and refer to the Example tab. To see the format of the response fields, as well as which are mandatory (that is, always returned in the response), select the tab Schema, and then expand object followed by content and finally object once more.

Request and Response

You might find it helpful to access our Sesame Data Developer Portal

The format of all Sesame Custodial Data APIs is the same. The user is required to provide their account UUID and token in the authorisation, and then make a GET request to the subportfolioholdings endpoint, specifying the entityId of the entity being requested.

get

Path parameters

entityIdinteger · int64required

Unique identifier provided by Landytech

Example: 123

Query parameters

fromDatestring · date

Start of Date Range (Inclusive)

Example: 2024-01-01

toDatestring · date

End of Date Range (Inclusive)

Example: 2024-12-31

lookThroughstring · default: "false"

Enable/disable look through

pageNumberinteger · int32 · default: 0

The current page, the first page should be '0'

pageSizeinteger · int32 · max: 100 · default: 100

Number of records per page

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://data.api.landytech.net/api/v1/subPortfolioHoldings/{entityId}'

200

200

{
  "content": [
    {
      "entityId": 36403,
      "date": "2024-02-08",
      "entityName": "HSBC (7095754)",
      "localCurrency": "GBP",
      "subPortfolioCode": "7095754.002.01",
      "marketValueLc": 379204.39
    }
  ],
  "totalPages": 1,
  "totalElements": 1,
  "last": true,
  "size": 100,
  "first": true,
  "number": 0,
  "numberOfElements": 1,
  "empty": false
}

OK