---
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)
    - `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)
    - `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).
    - `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
    - `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

---

[API](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api.md) · [All operations](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryspring/treasuryspring-public-api/versions/d587dda25444/schema)