---
title: "Get a single holding by id"
method: GET
path: "/holding/{entity_code}/{holding_uid}"
tags: ["Holdings"]
---

# Get a single holding by id

`GET /holding/{entity_code}/{holding_uid}`

Retrieves data for a single holding if the user has permission to view it.

## Path parameters

- `entity_code` string, required — Entity code
- `holding_uid` string, required — Holding uid

## Response `200`

Holding information

- SingleHolding — Single Holding schema.
  - `holding` Holding, required — Holding schema.
    - `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).
  - `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 `holding/extensionDays` to the response with the `200` status
  - added the optional property `holding/finalDays` to the response with the `200` status
  - added the optional property `holding/noticeDate` to the response with the `200` status
  - added the optional property `holding/selectableNextDatetime` to the response with the `200` status

[Change history](https://skmtc.dev/treasuryspring/apis/treasuryspring-public-api/changes/holding/:entity_code/:holding_uid/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)