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

# Annuity Calculator

`GET /api/calc/annuity-calculator`

## Request

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

An annuity calculator for fixed-term income: what a lump sum pays monthly over 10–30 years, or the pot needed for a target payment, level or rising yearly.

## Query parameters

- `mode` 'payout' | 'needed': I want to find
- `amount` number: Lump sum (starting balance)
- `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
- `rate` number: Annual interest rate (%) Compounded at the payment frequency.
- `years` number: Payout period (years)
- `frequency` '12' | '4' | '2' | '1': Payments
- `timing` 'end' | 'begin': Paid at
- `growth` number: Payment increase each year (%) E.g. 2–3% to keep pace with inflation.

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