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
- Version 1
- MCP tool
calc_finance_loan_emi - Try it in the browser
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).
| Input | Type | Description |
|---|---|---|
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.
| Result | Type | Description |
|---|---|---|
emi | decimal (string) | The monthly payment, rounded to the precision. Unit: currency. |
total_paid | decimal (string) | Sum of all payments in the schedule. Unit: currency. |
total_interest | decimal (string) | Total paid minus the principal. Unit: currency. |
last_payment | decimal (string) | The final payment, which clears the balance exactly. Unit: currency. |
number_of_payments | integer | Number of payments in the schedule. |
schedule | list of object | The amortization schedule (when include_schedule is true). |
Examples
250,000 at 7.5% over 20 years
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
}'
{
"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
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
}'
{
"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
- 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
- Amortization calculator (annuity payment formula)
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.