---
title: "Get loan"
method: GET
path: "/rest/loans/{loan-id}"
tags: ["Loans"]
---

# Get loan

`GET /rest/loans/{loan-id}`

Get loan by ID.

## Path parameters

- `loan-id` string, required — finX ID of the loan.

## Response `200`

Loan details.

- object
  - `id` Schema, required — unresolved $ref
  - `access_id` Schema, required — unresolved $ref
  - `name` string, required — Name of the loan product.
  - `type` 'BUSINESS' | 'PERSONAL' | 'MORTGAGE', required — The type of the loan indicating its usage.
  - `reference_id` string, required — Reference or identification code for the loan product as provided by the bank.
  - `linked_account` string — Identification of the account from which the installments are deducted. This is usually an IBAN.
  - `borrower` object, required — Details about the borrowing party.
    - `id` string — Identification number. For Spanish loans this can be the NIF/NIE.
    - `name` string, required — The name of the borrowing party.
  - `currency` string, ISO 4217:2015, required — Three-letter currency code.
  - `principal` number, float, required — The original amount of money that was agreed to borrow.
  - `balance` number, float, required — The amount of of money that is still owed to the lender. This is usually a negative value.
  - `matures_on` Schema, required — unresolved $ref
  - `interest` object, required
    - `rate` number, float, required — The interest rate in percent.
    - `type` 'FIXED' | 'VARIABLE', required — Indicates if the interest rate is fixed or variable throughout the runtime of the loan.
  - `next_payment_on` Schema — unresolved $ref
  - `next_payment_amount` number, float — The money amount to be paid with the next installment.
  - `last_payment_on` Schema — unresolved $ref
  - `last_payment_amount` number, float — The money amount that was paid with the last installment.
  - `created_at` CreatedAt, required — unresolved $ref
  - `modified_at` ModifiedAt, required — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `4XX` — unresolved $ref

---

[API](https://skmtc.net/qwist/apis/finx-api.md) · [All operations](https://skmtc.net/qwist/apis/finx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qwist/finx-api/revisions/b75f5c1aa39e/schema)