---
title: "Retrieves the buy-out and surplus details for a specific account"
method: GET
path: "/v1.0/target-unit-accounts/{accountId}/buy-out-surplus/"
tags: ["Buy-out and surplus info"]
---

# Retrieves the buy-out and surplus details for a specific account

`GET /v1.0/target-unit-accounts/{accountId}/buy-out-surplus/`

## Request

- Base URL: `http://localhost:8082/api`
- URL: `http://localhost:8082/api/v1.0/target-unit-accounts/{accountId}/buy-out-surplus/`
- Auth: HTTP bearer

## Path parameters

- `accountId` integer, required

## Response `200`

OK

- AccountBuyOutSurplusInfoDTO
  - `excluded` boolean
  - `surplusDetails` SurplusGainedDTO
    - `schemeVersion` 'CCA_2' | 'CCA_3'
    - `surplusGained` string, decimal
    - `hasHistory` boolean

## Other responses

- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-27** `2da910b8e923`: 1 warning, 1 info
  - removed the optional property `surplusGainedDTOList` from the response with the `200` status
  - added the optional property `surplusDetails` to the response with the `200` status
- **2026-04-02** `0be05036d2c8`: 3 warning
  - added the new `TP7` enum value to the `surplusGainedDTOList/items/targetPeriod` response property for the response status `200`
  - added the new `TP8` enum value to the `surplusGainedDTOList/items/targetPeriod` response property for the response status `200`
  - added the new `TP9` enum value to the `surplusGainedDTOList/items/targetPeriod` response property for the response status `200`
- **2025-09-11** `15b32331a1ac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beis/apis/api-documentation/changes/v1.0/target-unit-accounts/:accountId/buy-out-surplus/get.md)

---

[API](https://skmtc.dev/beis/apis/api-documentation.md) - [All operations](https://skmtc.dev/beis/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/beis/apis/api-documentation/revisions/2da910b8e923?raw)