---
title: "Retirement Calculator"
method: GET
path: "/api/calc/retirement-calculator"
tags: ["Finance"]
---

# Retirement Calculator

`GET /api/calc/retirement-calculator`

## Request

- Base URL: `https://calcbright.com`
- URL: `https://calcbright.com/api/calc/retirement-calculator`
- Auth: none declared

$800 a month from age 35 at 7% grows to about $1.38 million by 65. This retirement calculator projects your nest egg and how long withdrawals will last.

## Query parameters

- `age` number: Current age (years)
- `retireAge` number: Retirement age (years)
- `savings` number: Current retirement savings
- `currency` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'CHF' | 'CNY' | 'INR' | 'PKR' | 'AED' | 'SAR' | 'NZD' | 'SGD' | 'HKD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'TRY' | 'ZAR' | 'BRL' | 'MXN' | 'KRW' | 'THB' | 'MYR' | 'IDR' | 'PHP' | 'BDT' | 'EGP' | 'NGN' | 'KWD' | 'QAR' | 'BHD' | 'OMR' | 'RUB': Currency
- `monthly` number: Monthly contribution
- `rate` number: Expected return (before retiring) (%)
- `years` number: Years in retirement (years)
- `withdrawal` number: Monthly withdrawal in retirement
- `retireRate` number: Return during retirement (%)

## Response `200`

Calculation result

- CalcOutput
  - `ok` boolean
  - `tool` string
  - `name` string
  - `url` string: Open this link to see the full calculation
  - `inputs` object
  - `summary` string: Plain-text answer
  - `details` string
  - `result` object
  - `errors` object

## Other responses

- `400`: Invalid input (see errors)

---

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