---
title: "List events that effects loans."
method: GET
path: "/v1/loans/events"
tags: ["Loans"]
---

# List events that effects loans.

`GET /v1/loans/events`

## Headers

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

## Response `200`

Request was fulfilled and events of loans are listed.

- LoanEventsResponse — The cumulative response of the loans events.
  - `events` LoanEvent[], nullable — Lists of the events that affect the properties of a loan.
    - `accountId` string, nullable — The internal technical identifier of the account which has the loans in some of the banks or other financial institutions.
    - `balance` number, double, nullable — The current balance of the account loan.
    - `interestRate` number, double, nullable — The interest rate is the percentage of the loan amount charged for borrowing the principal. It is a re-occurring fee the borrower must pay, in addition to the principal. The rate at which interest is charged is always recorded in the promissory note.
    - `interestRateChange` number, double, nullable — The change of the interest rate.
    - `loanName` string, nullable — Loan display name.
    - `loanType` 'BLANCO' | 'CREDIT' | 'LAND' | 'MEMBERSHIP' | 'MORTGAGE' | 'OTHER' | 'STUDENT' | 'VEHICLE' — The possible types of loans.
    - `name` string, nullable — Name of the loan event.
    - `nextTermsModificationDay` integer, nullable — A terms modification day is a point in time when the initial fixed interest rate changes after the defined period.
    - `providerId` string, nullable — Bank or other financial institution identifier which approved the loan.
    - `timestamp` integer, nullable — A timestamp of the loan event.
    - `type` string, nullable — Type of the event.

## 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/revisions/7fc3b4f800ae/schema)