curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

Loan EMI API

Monthly instalment (EMI), total interest and an exact amortization schedule for a fixed-rate loan.

POST https://api.curatedapi.com/v1/calc/finance/loan/emi

Computes the equated monthly instalment for a fixed-rate loan repaid in equal monthly payments, the total paid and the total interest. The schedule is computed the way lenders do it: each month's interest is rounded to the cent, every payment is the rounded EMI, and the final payment is adjusted so the balance ends at exactly zero. Totals are the sums of that schedule, so they always add up to the cent.

Formula

EMI = P·r·(1+r)^n / ((1+r)^n − 1), r = annual rate ÷ 12 ÷ 100 (EMI = P/n if r = 0)
  • Amounts are plain numbers in any single currency; no currency conversion is done.
  • The EMI itself is computed exactly and rounded once. Each month's interest is rounded with the same precision and rounding mode (default: to the cent, half-even).
  • Payments are made at the end of each month (ordinary annuity).

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
principal required decimal (string) Amount borrowed. Allowed: > 0 and <= 1000000000000000. Unit: currency.
annual_rate_percent required decimal (string) Nominal annual interest rate in percent (7.5 means 7.5%), compounded monthly. Allowed: >= 0 and <= 100. Unit: percent.
term_months required integer Number of monthly payments. Allowed: >= 1 and <= 1200.
include_schedule boolean
default False
Also return the month-by-month schedule.
options.rounding half_even | half_up | half_down | up | down | ceiling | floor Rounding mode applied once to each result. Default half_even.
options.decimals integer Round results to this many digits after the decimal point.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
emidecimal (string)The monthly payment, rounded to the precision. Unit: currency.
total_paiddecimal (string)Sum of all payments in the schedule. Unit: currency.
total_interestdecimal (string)Total paid minus the principal. Unit: currency.
last_paymentdecimal (string)The final payment, which clears the balance exactly. Unit: currency.
number_of_paymentsintegerNumber of payments in the schedule.
schedulelist of objectThe amortization schedule (when include_schedule is true).

Examples

250,000 at 7.5% over 20 years

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/loan/emi \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "principal": "250000",
    "annual_rate_percent": "7.5",
    "term_months": 240
  }'
200 OKResponse
{
  "calculator": "finance/loan/emi@1",
  "result": {
    "emi": "2013.98",
    "total_paid": "483356.89",
    "total_interest": "233356.89",
    "last_payment": "2015.67",
    "number_of_payments": 240
  },
  "exactness": {
    "emi": "exact",
    "total_paid": "exact",
    "total_interest": "exact",
    "last_payment": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "principal": "250000",
    "annual_rate_percent": "7.5",
    "term_months": 240,
    "include_schedule": false
  },
  "formula": "EMI = P·r·(1+r)^n / ((1+r)^n − 1), r = annual rate ÷ 12 ÷ 100 (EMI = P/n if r = 0)",
  "references": [
    {
      "title": "CFPB Regulation Z Appendix H, form H-24(B) sample Loan Estimate: $162,000 at 3.875% for 30 years has a monthly principal and interest payment of $761.78",
      "url": "https://www.consumerfinance.gov/rules-policy/regulations/1026/h/"
    },
    {
      "title": "Amortization calculator (annuity payment formula)",
      "url": "https://en.wikipedia.org/wiki/Amortization_calculator"
    }
  ],
  "warnings": []
}

CFPB sample: 162,000 at 3.875% over 30 years

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/loan/emi \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "principal": "162000",
    "annual_rate_percent": "3.875",
    "term_months": 360
  }'
200 OKResponse
{
  "calculator": "finance/loan/emi@1",
  "result": {
    "emi": "761.78",
    "total_paid": "274243.67",
    "total_interest": "112243.67",
    "last_payment": "764.65",
    "number_of_payments": 360
  },
  "exactness": {
    "emi": "exact",
    "total_paid": "exact",
    "total_interest": "exact",
    "last_payment": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "principal": "162000",
    "annual_rate_percent": "3.875",
    "term_months": 360,
    "include_schedule": false
  },
  "formula": "EMI = P·r·(1+r)^n / ((1+r)^n − 1), r = annual rate ÷ 12 ÷ 100 (EMI = P/n if r = 0)",
  "references": [
    {
      "title": "CFPB Regulation Z Appendix H, form H-24(B) sample Loan Estimate: $162,000 at 3.875% for 30 years has a monthly principal and interest payment of $761.78",
      "url": "https://www.consumerfinance.gov/rules-policy/regulations/1026/h/"
    },
    {
      "title": "Amortization calculator (annuity payment formula)",
      "url": "https://en.wikipedia.org/wiki/Amortization_calculator"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.