---
title: "Savings Goal Calculator"
method: POST
path: "/api/v1/tools/savings-goal-calculator"
tags: ["tools"]
---

# Savings Goal Calculator

`POST /api/v1/tools/savings-goal-calculator`

## Request

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

A savings goal from either end. monthsToGoal walks the months at a given deposit until the balance clears the goal and reports the quarter marks along the way; requiredDeposit solves the other way round for the monthly amount a deadline needs. Both include interest compounded monthly.

## Request body

- object
  - `mode` string
  - `goal` integer
  - `currentSavings` integer
  - `monthlyDeposit` integer
  - `months` integer
  - `annualRatePercent` number

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `mode` string
    - `goal` integer
    - `currentSavings` integer
    - `annualRatePercent` number
    - `alreadyThere` boolean
    - `months` integer
    - `monthlyDeposit` integer
    - `totalDeposited` integer
    - `interestEarned` number
    - `finalBalance` number
    - `schedule` object[]
      - `month` integer
      - `balance` number
      - `note` string

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