---
title: "Get loans."
method: GET
path: "/v1/loans"
tags: ["Loans"]
---

# Get loans.

`GET /v1/loans`

## Headers

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

## Response `200`

Request was fulfilled and loans are listed.

- LoansResponse — The cumulative response of the loans.
  - `loans` Loan[], nullable — List of all loans that user has in selected bank or financial institution.
    - `averageMonthlyOutgoingLoanPayment` number, double, nullable
    - `calendarMonths` integer, nullable
    - `calendarMonthsWithIncomingLoans` integer, nullable
    - `calendarMonthsWithOutgoingLoans` integer, nullable
    - `daysSinceLastIncomingLoan` integer, nullable
    - `loansByCategory` LoanDetails[], nullable
      - `averageMonthlyOutgoingLoanPayment` number, double, nullable
      - `categoryId` CategoryId
        - `expense` string, nullable
        - `income` string, nullable
      - `categoryTitle` string, nullable
      - `daysSinceLastIncomingLoan` integer, nullable
      - `monthlyIncomingLoanTrend` number, double, nullable
      - `monthlyOutgoingLoanTrend` number, double, nullable
      - `numberOfIncomingLoanSources` integer, nullable
      - `numberOfOutgoingLoanSources` integer, nullable
      - `ratioOfOutgoingLoanCategoryToLoans` number, double, nullable
    - `monthlyIncomingLoanTrend` number, double, nullable
    - `monthlyOutgoingLoanTrend` number, double, nullable
    - `ratioOfIncomingLoansToAllIncome` number, double, nullable
    - `ratioOfOutgoingLoansToAllExpenses` number, double, nullable
  - `overallAmount` number, double, nullable — The overall amount of all loans.
  - `weightedAverageInterestRate` number, double, nullable — A weighted average interest rate is an average that is adjusted to reflect the contribution of each loan to the total debt. The weighted average multiplies each loan’s interest rate by the loan balance and divides the sum by the total loan balance.

## 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)