---
title: "Retirement Monte Carlo Calculator"
method: POST
path: "/api/v1/tools/retirement-monte-carlo-calculator"
tags: ["savings"]
---

# Retirement Monte Carlo Calculator

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

## Request

- Base URL: `https://calcfleet.com`
- URL: `https://calcfleet.com/api/v1/tools/retirement-monte-carlo-calculator`
- Auth: none declared

Estimate your retirement plan's success probability with 5,000 simulated Monte Carlo market paths, plus a fan chart of percentile balances at every age.

## Request body

- object
  - `currentAge` integer, required
  - `retireAge` integer, required
  - `currentSavings` number, required
  - `monthlyContribution` number, required
  - `expectedRealReturnPct` number, required
  - `volatilityPct` number, required
  - `monthlyRetirementSpending` number, required
  - `planUntilAge` integer, required

## Response `200`

Successful calculation result.

- object
  - `result` object, required: Structured calculation output (fields vary per calculator).

## Other responses

- `400`: Invalid input — the issues array contains Zod validation errors.
- `403`: Forbidden — an Authorization: Bearer cf_… key was supplied but is invalid.
- `404`: Unknown tool slug.

---

[API](https://skmtc.dev/calcfleet/apis/calcfleet-financial-calculators-api.md) · [All operations](https://skmtc.dev/calcfleet/apis/calcfleet-financial-calculators-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calcfleet/apis/calcfleet-financial-calculators-api/revisions/cd9abd595bbe?raw)