---
title: "Debt Payoff Calculator"
method: POST
path: "/api/v1/tools/debt-payoff-calculator"
tags: ["tools"]
---

# Debt Payoff Calculator

`POST /api/v1/tools/debt-payoff-calculator`

## Request

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

Take a list of debts with balance, APR and minimum payment, add whatever extra you can pay each month, and simulate both payoff strategies: snowball, which clears the smallest balance first, and avalanche, which clears the dearest first. Returns months to debt free, total interest and the payoff order for each, plus what avalanche saves.

## Request body

- object
  - `debts` object[]
    - `name` string
    - `balance` integer
    - `aprPercent` integer
    - `minPayment` integer
  - `extraMonthlyPayment` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `totalBalance` integer
    - `totalMinimumPayment` integer
    - `extraMonthlyPayment` integer
    - `snowball` object
      - `strategy` string
      - `months` integer
      - `totalInterest` number
      - `payoffOrder` object[]
        - `name` string
        - `month` integer
      - `paidOff` boolean
    - `avalanche` object
      - `strategy` string
      - `months` integer
      - `totalInterest` number
      - `payoffOrder` object[]
        - `name` string
        - `month` integer
      - `paidOff` boolean
    - `interestSavedByAvalanche` integer
    - `monthsSavedByAvalanche` integer
    - `underwater` unknown[]
      - unknown

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