---
title: "List historical rates and balances for all loans together."
method: GET
path: "/v1/loans/history"
tags: ["Loans"]
---

# List historical rates and balances for all loans together.

`GET /v1/loans/history`

## Headers

- `sessionId` string, uuid
- `authorizationId` string, uuid

## Response `200`

Request was fulfilled and history of loans are listed.

- LoanTimelinesResponse — The cumulative response of the loans timelines including rate changes, balances and weighted average calculations.
  - `timelines` LoanTimeline[], nullable — List of loan timelines.
    - `accountId` string, nullable — The internal technical identifier of the account which has the loans in the bank or other financial institution.
    - `balanceTimeline` PairLongDateDoubleValue[], nullable — List of balances on date of their changes.
      - `date` integer, nullable — Unix epoch timestamp milliseconds.
      - `value` number, double, nullable — Value in that moment.
    - `interestRateTimeline` PairLongDateDoubleValue[], nullable — List of interest rates on date of their changes.
      - `date` integer, nullable — Unix epoch timestamp milliseconds.
      - `value` number, double, nullable — Value in that moment.
  - `weightedAverageTimeline` PairStringKeyDoubleValue[], nullable — A weighted average interest rate during time for all loans. The key is in format "yyyy-MM".
    - `key` string, nullable — The key name.
    - `value` number, double, nullable — Value of the selected key.

## Other responses

- `400` — Error caused by invalid or missing data.
- `401` — Authentication failed due to missing or invalid credentials.
- `403` — Error caused by end user (PSU) not permitted access to the resource.
- `404` — Endpoint does not exist or URL is not constructed correctly.
- `500` — Error caused by remote technical issues, this status code is used for unforeseen technical issues.
- `503` — Returned when service is unavailable due to scheduled reasons, such as maintenance.
- `504` — Returned when request has been timed out in the gateway.

---

[API](https://skmtc.net/finshark/apis/finshark-api.md) · [All operations](https://skmtc.net/finshark/apis/finshark-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finshark/finshark-api/versions/7fc3b4f800ae/schema)