---
title: "Loan Calculator"
method: POST
path: "/api/v1/tools/loan-calculator"
tags: ["tools"]
---

# Loan Calculator

`POST /api/v1/tools/loan-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/loan-calculator`
- Auth: HTTP bearer

Work out an annuity loan from the amount, annual interest rate and term: the fixed monthly payment, total paid, total interest and an amortisation schedule of up to 360 months showing principal, interest and remaining balance.

## Request body

- object
  - `amount` integer
  - `annualRatePercent` number
  - `term` integer
  - `termUnit` string

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `amount` integer
    - `annualRatePercent` number
    - `termMonths` integer
    - `monthlyPayment` number
    - `totalPaid` number
    - `totalInterest` number
    - `interestToPrincipalRatio` number
    - `schedule` object[]
      - `month` integer
      - `payment` number
      - `principal` number
      - `interest` number
      - `balance` number
    - `scheduleTruncated` boolean

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)