Utilities

Amortize a fixed-rate loan

Computes the level monthly payment, total interest, payoff time, and an optional per-period amortization schedule. Supports an optional extra monthly principal payment, which shortens the term. Deterministic.

post/v1/loan/amortization

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/loan/amortization
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

principalnumber required

Amount borrowed (<= 1e12).

annual_ratenumber required

Nominal APR (0–4, i.e. up to 400%).

term_monthsinteger required
extra_monthly_paymentnumber

Extra principal each month; shortens the term.

include_scheduleboolean

Return the full per-period schedule (can be large).

Example request

{
  "principal": 300000,
  "annual_rate": 0.065,
  "term_months": 360
}

Response

Amortization result

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "loan_1a2b3c4d5e6f7a8b",
  "engine_version": "loan-1.0.0",
  "inputs": {
    "principal": 300000,
    "annual_rate": 0.065,
    "term_months": 360
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.