---
title: "Get the extension history for a holding"
method: GET
path: "/holding/{entity_code}/{holding_uid}/extension"
tags: ["Holdings"]
---

# Get the extension history for a holding

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

Retrieves the extension history of an extendable holding, most recent first. Each extension records the
yield, price per share, and new maturity date applied at that extension. Fixed holdings have no extensions.

## Path parameters

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

## Query parameters

- `limit` integer — Page size used for pagination
- `offset` integer — Offset used for pagination

## Response `200`

Paginated list of extensions for the holding

- PaginatedExtensions — PaginatedExtensions schema.
  - `extensions` Extension[], required
    - `date` string, date, required — Date the extension took effect
    - `finalYield` number, nullable — Final period yield, annualised APY (set on the final extension only).
    - `maturity` string, date, required — Maturity date set by this extension
    - `pricePerShare` number, required — Price per share at the extension
    - `tradeDate` string, date, required — Date the extension option was exercised (the portal calls this the option extension date). On a SPOT extendable it matches `date`. On a FORWARD extendable it can precede `date`, because the extension is traded on the option date while the new yield takes effect only when the previous period matures.
    - `uid` string, required — Extension uid
    - `yield` number, required — Yield for this extension period (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

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `9f98bc61d12b` — 1 info
  - added the required property `extensions/items/tradeDate` to the response with the `200` status

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