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

# Retirement Calculator

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

## Request

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

Project a pension pot from what is saved now, what goes in every month, the return and the years left until retirement. Returns the pot at the retirement age, the same pot restated in today's money at an inflation rate, what the 4% rule would pay per month, and a year-by-year table.

## Request body

- object
  - `currentAge` integer
  - `retirementAge` integer
  - `currentSavings` integer
  - `monthlyContribution` integer
  - `annualReturnPercent` integer
  - `annualInflationPercent` number

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `currentAge` integer
    - `retirementAge` integer
    - `yearsToRetire` integer
    - `currentSavings` integer
    - `monthlyContribution` integer
    - `annualReturnPercent` integer
    - `annualInflationPercent` number
    - `nestEgg` number
    - `nestEggInTodaysMoney` number
    - `totalContributed` integer
    - `totalGrowth` number
    - `monthlyIncome` number
    - `monthlyIncomeInTodaysMoney` number
    - `yearlyBreakdown` object[]
      - `age` integer
      - `contributed` integer
      - `balance` number
      - `todaysValue` number

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