simulate_loan_prepayment

Simulate prepaying a home loan — interest saved and tenure/EMI impact for a lump-sum or recurring prepayment. Not financial advice.

Endpoint POST https://api.avnester.com/public/v1/simulate_loan_prepayment

Parameters

The most-used parameters. Full schema in the OpenAPI document.

Name	Type	Required	Description
outstandingPrincipal	number	required	Current outstanding principal in INR.
remainingTenureYears	number	required	Years left at the current EMI.
annualRatePercent	number	optional	Annual interest rate. Defaults to the indicative market rate.
prepaymentAmount	number	optional	One-time lump-sum prepayment in INR.
recurringAnnualAmount	number	optional	Recurring yearly prepayment in INR.
prepaymentMode	string	optional	one_time · recurring_annual · one_time_plus_recurring.
strategy	string	optional	reduce_tenure · reduce_emi · compare_both (default).

Worked example

# ₹5L one-time prepayment on a ₹52L loan, 20 years left at 8.5%

curl -X POST https://api.avnester.com/public/v1/simulate_loan_prepayment \
  -H 'Content-Type: application/json' \
  -d '{
       "outstandingPrincipal": 5200000,
       "remainingTenureYears": 20,
       "annualRatePercent": 8.5,
       "prepaymentAmount": 500000,
       "strategy": "compare_both"
     }'

Response

{
  "baseline": { "emi": 45127, "payoffMonths": 240, "totalInterest": 5630434 },
  "reduceTenure": { "emi": 45127, "payoffMonths": 190, "interestSaved": 1773475, "monthsSaved": 50 },
  "reduceEmi": { "emi": 40788, "payoffMonths": 240, "interestSaved": 541388, "monthsSaved": 0 },
  "attribution": "AVnester",
  "disclaimer": "..."
}

Rate limits

Anonymous

60/min

OAuth (Team)

600/min

Per-IP aggregate cap (across all tools): 60/min. OAuth registration lifts both the per-tool budget (10×) and removes the IP cap.

Common errors

400Invalid request body
Check required parameters and types. The error.message field will name the offending parameter.
429Rate limit exceeded
Back off until the time in the Retry-After header; or authenticate with OAuth for the 10× tier.

Next steps

→ Try simulate_loan_prepayment in the playground (no signup, anon tier)
→ Register an OAuth client (10× rate budget)
→ Browse the other 6 tools
→ Full schema in the OpenAPI spec