---
title: "Retrieves the surplus history for a specific facility"
method: GET
path: "/v1.0/facilities/{facilityId}/buy-out-surplus/history"
tags: ["Buy-out and surplus info"]
---

# Retrieves the surplus history for a specific facility

`GET /v1.0/facilities/{facilityId}/buy-out-surplus/history`

## Request

- Base URL: `http://localhost:8082/api`
- URL: `http://localhost:8082/api/v1.0/facilities/{facilityId}/buy-out-surplus/history`
- Auth: HTTP bearer

## Path parameters

- `facilityId` 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 info
  - endpoint added

[Operation history](https://skmtc.dev/beis/apis/api-documentation/changes/v1.0/facilities/:facilityId/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)