---
title: "Compute amortizing mortgage payment + total interest"
method: GET
path: "/calculators/mortgage"
tags: ["Calculators"]
---

# Compute amortizing mortgage payment + total interest

`GET /calculators/mortgage`

## Request

- Base URL: `https://tulugar.com/api/v1`
- URL: `https://tulugar.com/api/v1/calculators/mortgage`
- Auth: none declared

Currency-agnostic. Returns monthly payment, total paid, total interest, and (optionally) debt-to-income ratio.

## Query parameters

- `principal` number, required
- `annual_rate` number, required
- `term_years` number, required
- `monthly_income` number

## Response `200`

Single resource

- object
  - `data` MortgageEstimate
    - `inputs` object
      - `principal` number
      - `annual_rate` number
      - `annual_rate_pct` number
      - `term_years` number
      - `monthly_income` number, nullable
    - `estimate` object
      - `monthly_payment` number
      - `total_payments` integer
      - `total_paid` number
      - `total_interest` number
      - `debt_to_income_ratio` number, nullable
    - `summary` string
    - `disclaimer` string
    - `docs_url` string
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Validation error
- `429`: Rate limited
- `500`: Server error

---

[API](https://skmtc.dev/tulugar/apis/tu-lugar-api.md) · [All operations](https://skmtc.dev/tulugar/apis/tu-lugar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tulugar/apis/tu-lugar-api/revisions/868219e90320?raw)
