---
title: "Get a list of all holdings"
method: GET
path: "/holding"
tags: ["Holdings"]
---

# Get a list of all holdings

`GET /holding`

Retrieves a list of all holdings that the user has permission to view.

## Query parameters

- `entity_code` string, nullable — Parameter to filter holdings by entity code
- `min_subscription_date` string, date, nullable — Parameter to filter holdings by minimum subscription date
- `max_subscription_date` string, date, nullable — Parameter to filter holdings by maximum subscription date
- `min_maturity_date` string, date, nullable — Parameter to filter holdings by minimum maturity date
- `max_maturity_date` string, date, nullable — Parameter to filter holdings by maximum maturity date
- `min_modified_date` string, date, nullable — Parameter to filter holdings by modification date
- `limit` integer — Page size used for pagination
- `offset` integer — Offset used for pagination

## Response `200`

List of holdings

- PaginatedHoldings — PaginatedHoldings schema.
  - `holdings` Holding[], required
    - `calendars` string[], required — List of calendars followed by product
    - `cellCode` string, required — Cell Code
    - `cost` number, required — Holding initial cost
    - `currency` string, nullable — Holding currency
    - `cutoffDatetime` string, date-time, nullable — Cutoff date with timezone information
    - `entityCode` string, required — Investing Entity Code
    - `extendedMaturityDate` string, date, nullable — New maturity date for an extension (extendables only)
    - `extensionDays` integer, nullable — Length of the current extension period in CALENDAR days (extendables only). The option and maturity dates derived from it are then adjusted onto business days, so the realised gap between two option dates can differ from this number.
    - `extensionOptionDate` string, date, nullable — Extension option date (extendables only)
    - `extensionStartDate` string, date, nullable — Start date for an extension (extendables only)
    - `extensionStartValue` number, nullable — Initial value for current extension (extendables only)
    - `finalDays` integer, nullable — Length of the final period in CALENDAR days (extendables only), business-day adjusted the same way as `extensionDays`.
    - `finalYield` number, nullable — Final period yield, annualised APY (extendables only).
    - `finalized` boolean, nullable — True if this is the final extension (extendables only)
    - `isOnBalanceSheet` boolean, required — True if holding value can be counted for balance sheet calculations, False otherwise
    - `issueDate` string, date, required — Date the FTF was issued, otherwise known as Subscription date
    - `maturityActions` MaturityAction[] — Maturity actions (next actions) for this holding — what happens to the holding's value at maturity. Upcoming for live holdings; reflects the action(s) applied for matured or redeemed holdings. Empty if no actions are set.
      - `amount` number, required — Amount
      - `currency` string, required — Currency
      - `holdingUid` string, required — Holding uid
      - `subscriptionUid` string, nullable — The unique identifier for the subscription associated with the maturity action, if any.
      - `type` string, required — Maturity Action type
      - `uid` string, required — Maturity Action uid
    - `maturityDate` string, date, required — Date the FTF holding will mature
    - `maturityValue` number, required — Value at maturity
    - `maturityValueAdjustment` number, nullable — Adjustment on the maturity value (usually 0)
    - `mmyA365F` number, nullable — Same return as `yield`, expressed in MMYA365F format. Use only when you specifically need this format.
    - `name` string, nullable — FTF name
    - `nextFinalYield` number, nullable — Next final period yield, annualised APY (extendables only).
    - `nextYield` number, nullable — Next extension yield, annualised APY (extendables only).
    - `noticeDate` string, date, nullable — Last business day before cut-off — after this the maturity action window is closing
    - `obligorExposureCode` string, required — Obligor Exposure Code
    - `obligorExposureName` string, required — Obligor Exposure Name
    - `pricePerShare` number, nullable — Price per share
    - `productCode` string, nullable — The FTF product code
    - `selectableNextDatetime` string, date-time, nullable — When a SWITCH becomes selectable on this holding; timezone-aware
    - `status` 'Cash' | 'Pending' | 'PendingWithdrawal' | 'Issued' | 'Redeemed' | 'Cancelled' | 'CutOff' | 'Processing', required
    - `subscriptionUid` string, nullable — The unique identifier for the subscription associated with the holding.
    - `type` string, required — The type of product, Fixed or Extendable
    - `uid` string, required — The unique identifier for the holding
    - `value` number, required — Current value
    - `yield` number, nullable — Current yield (annualised APY).
  - `pageInfo` PageInfo, required — PageInfo schema.
    - `hasNextPage` boolean, nullable, required — Boolean indicating if there is a next page of items available
    - `hasPreviousPage` boolean, nullable, required — boolean indicating if there is a previous page
    - `limit` integer, nullable, required — Limit or page size set (used for pagination)
    - `offset` integer, nullable, required — Offset of items (used for pagination)
    - `totalCount` integer, nullable, required — Total number of items available
  - `valueDate` string, date, required — Date of the response (London timezone)

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `9f98bc61d12b` — 4 info
  - added the optional property `holdings/items/extensionDays` to the response with the `200` status
  - added the optional property `holdings/items/finalDays` to the response with the `200` status
  - added the optional property `holdings/items/noticeDate` to the response with the `200` status
  - added the optional property `holdings/items/selectableNextDatetime` to the response with the `200` status

[Change history](https://skmtc.dev/treasuryspring/apis/treasuryspring-public-api/changes/holding/get.md)

---

[API](https://skmtc.dev/treasuryspring/apis/treasuryspring-public-api.md) · [All operations](https://skmtc.dev/treasuryspring/apis/treasuryspring-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/treasuryspring/treasuryspring-public-api/revisions/9f98bc61d12b/schema)