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

# Retrieves the surplus history for a specific account

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

## Request

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

## Path parameters

- `accountId` integer, required

## Response `200`

OK

- SurplusHistoryDTO[]
  - `surplusGained` string, decimal
  - `comments` string
  - `submitter` string
  - `submissionDate` string, date-time

## Other responses

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

## Changes

- **2026-10-27** `2da910b8e923`: 1 warning, 1 info
  - deleted the `query` request parameter `targetPeriod`
  - api operation id `getAllSurplusHistoryByTargetPeriodAndAccountId` removed and replaced with `getSurplusHistoryByAccountId`
- **2026-04-02** `0be05036d2c8`: 3 info
  - added the new enum value `TP7` to the `query` request parameter `targetPeriod`
  - added the new enum value `TP8` to the `query` request parameter `targetPeriod`
  - added the new enum value `TP9` to the `query` request parameter `targetPeriod`
- **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/history/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)