---
title: "Annuity PV / FV / Payment Solver"
method: POST
path: "/v1/tools/compute_annuity"
tags: ["TODO_TAGS_REVIEW"]
---

# Annuity PV / FV / Payment Solver

`POST /v1/tools/compute_annuity`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_annuity`
- Auth: none declared

Solves present value, future value, or payment for an ordinary annuity or annuity-due, given the other two plus rate and number of periods, using the standard closed-form annuity factor. Matches Excel PV/FV/PMT semantics including the due=true (beginning-of-period) adjustment.

**Tool URL:** https://ainumbers.co/chaingraph/art-327-tvm-annuity.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `due` boolean, required
  - `fv` number
  - `nper` number
  - `pmt` number
  - `pv` number
  - `rate_pct` number: Percentage value
  - `solve_for` 'fv' | 'pmt' | 'pv', required

## Response `200`

Successful tool execution result

- object
  - `annuity_factor` number
  - `due` boolean
  - `fv` integer
  - `note` string
  - `nper` integer
  - `pmt` integer
  - `pv` number
  - `rate_pct` number
  - `regulatory_basis` string
  - `solved_for` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)