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

---

[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)