# 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

{% hint style="info" %}
You might find it helpful to access our [sesame-data-developer-portal](https://docs.landytech.com/sesame-data-developer-portal "mention")
{% endhint %}

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.

{% openapi src="<https://686422464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRqYhxcZf6UoirhKFZnW4%2Fuploads%2Fl8kOz8iaZGcmfcJzGmQz%2Fopenapi_114_06Jun25.yaml?alt=media&token=d7c18101-35d7-4f9d-b950-e2a3b428bd2a>" path="/api/v1/subPortfolioHoldings/{entityId}" method="get" expanded="true" %}
[openapi\_114\_06Jun25.yaml](https://686422464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRqYhxcZf6UoirhKFZnW4%2Fuploads%2Fl8kOz8iaZGcmfcJzGmQz%2Fopenapi_114_06Jun25.yaml?alt=media\&token=d7c18101-35d7-4f9d-b950-e2a3b428bd2a)
{% endopenapi %}