---
title: "Changes to Get details of a pension fund policy"
method: GET
path: "/policies/{policyId}"
---

# Changes to Get details of a pension fund policy

`GET /policies/{policyId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 24 revisions.

- **2025-04-17** `0c781dae9ac9`: 8 breaking, 1 warning, 3 info
- **2025-02-07** `87835f5abbb4`: 3 breaking, 5 info
- **2025-01-16** `daf666928ad4`: 4 breaking, 3 warning, 6 info

## Changes

- **2025-04-17** `0c781dae9ac9`: 8 breaking, 1 warning, 3 info
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/balanceBeginningLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/balanceEndLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/interestCreditLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/interestRatesLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/oldAgeCreditLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/totalDepositsLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment/totalWithdrawalsLastYear` became optional for the status `200`
  - the response property `personalPensionDetails/retirementCapital/projectedRetirementBenefits/items/pension` became optional for the status `200`
  - removed the optional property `personalPensionDetails/vestedBenefits/homeOwnerhsipWithdrawals` from the response with the `200` status
  - added the optional property `personalPensionDetails/vestedBenefits/homeOwnershipWithdrawals` to the response with the `200` status
  - the response property `personalPensionDetails/retirementCapital/lastYearDevelopment` became required for the status `200`
  - the response property `personalPensionDetails/vestedBenefits` became required for the status `200`
- **2025-02-07** `87835f5abbb4`: 3 breaking, 5 info
  - the response property `personalPensionDetails/vestedBenefits/divorceWithdrawals/items/amountMandatory` became optional for the status `200`
  - the response property `personalPensionDetails/vestedBenefits/homeOwnerhsipWithdrawals/items/amountMandatory` became optional for the status `200`
  - the response property `personalPensionDetails/vestedBenefits/voluntaryPurchases/items/amountMandatory` became optional for the status `200`
  - added the non-success response with the status `500`
  - added the optional property `personalPensionDetails/homeOwnershipAvailableForPledge` to the response with the `200` status
  - added the optional property `personalPensionDetails/retirementCapital/lastYearDevelopment` to the response with the `200` status
  - the response property `personalPensionDetails/riskBenefits/lumpSumWithoutPensionBenefits` became required for the status `200`
  - added the required property `pensionPlan/contractType` to the response with the `200` status
- **2025-01-16** `daf666928ad4`: 4 breaking, 3 warning, 6 info
  - removed the required property `financing` from the response with the `200` status
  - removed the required property `retirementCapital` from the response with the `200` status
  - removed the required property `riskBenefits` from the response with the `200` status
  - removed the required property `salaryData` from the response with the `200` status
  - removed the optional property `homeOwnershipAvailableForWithdrawal` from the response with the `200` status
  - removed the optional property `regularPurchaseMaxAmount` from the response with the `200` status
  - removed the optional property `vestedBenefits` from the response with the `200` status
  - the endpoint scheme security `OAuth2` was added to the API
  - added the optional property `employer` to the response with the `200` status
  - the response property `contractNo` became required for the status `200`
  - the response property `pensionPlan` became required for the status `200`
  - added the required property `personalPensionDetails` to the response with the `200` status
  - added the required property `referenceDate` to the response with the `200` status

---

[Operation](https://skmtc.dev/swissfintechinnovations/apis/pension-2/docs/policies/:policyId/get.md) - [API](https://skmtc.dev/swissfintechinnovations/apis/pension-2.md) - [Page](https://skmtc.dev/swissfintechinnovations/apis/pension-2/changes/policies/:policyId/get)