Documentation

Understand how Talovex optimizes student loan repayment plans, or integrate our optimization engine into your own application via the REST API.

API Endpoints

POST/v1/calculate
GET/v1/plans
GET/v1/poverty-guidelines
POST/v1/pslf-check
POST/v1/signup
POST/v1/login
POST/v1/checkout

Authentication

All API requests require an API key passed via the X-API-Key header.

curl https://talovex-api.smarttechinvest.com/v1/plans \
  -H "X-API-Key: tlv_your_api_key_here"

NPV Comparison Model

For each eligible plan, we compute the total net present value as:

NPV = Sum(Monthly Payment / (1 + r)^t) + PV(Tax Bomb) - PV(Forgiveness Tax Savings)

Monthly payments are computed using each plan's specific formula: percentage of discretionary income (AGI minus poverty guideline multiplier), interest subsidy rules, and payment caps. The discount rate reflects the borrower's opportunity cost of capital.

Daily simple interest accrual (not compound) is used per federal loan rules. This is a critical distinction that most calculators get wrong -- federal student loans do not compound interest on the principal.

Monte Carlo Income Simulation

IDR payments are a function of income. Your income is not a straight line -- it follows a stochastic path with variance that depends on your occupation, industry, and career stage.

We draw 1,000+ income trajectories from BLS Occupational Employment and Wage Statistics (OES) distributions, calibrated to your current income and occupation. Each trajectory produces a different payment stream under each IDR plan, giving you:

  • Expected (mean) NPV cost -- the average across all scenarios
  • Median NPV cost -- the 50th percentile
  • 95th percentile cost -- your worst-case planning number
  • Confidence intervals -- how wide is the range of possible outcomes

PSLF Breakeven Analysis

Public Service Loan Forgiveness requires 120 qualifying payments while employed by a qualifying employer (government or 501(c)(3)). Not every borrower benefits from PSLF -- if your income is high enough that IDR payments nearly cover the full balance, there is little left to forgive.

We compute the breakeven point: the income level at which PSLF stops saving you money compared to aggressive Standard plan payoff. We also model partial PSLF credit for borrowers who have already made qualifying payments.

Tax Bomb Modeling

Under IDR plans (non-PSLF), any remaining balance forgiven after 20 or 25 years is treated as taxable income. The ARPA exemption that temporarily excluded forgiven student debt from taxation expired December 31, 2025.

We project the forgiven balance at the end of your IDR timeline, apply your estimated marginal federal and state tax rate at that future date, and discount the tax liability back to present value. This "tax bomb" is included in the NPV comparison so you can see the true cost of IDR forgiveness.

Spousal Optimization

For married borrowers, filing status directly affects IDR payment calculations. Under some plans (IBR, PAYE), filing Married Filing Separately excludes spouse income from the payment calculation -- but you lose tax benefits of filing jointly. Under RAP and REPAYE, spouse income is always included regardless of filing status.

We model both MFJ and MFS scenarios, computing the combined household tax impact and IDR payment difference, then recommend the filing strategy that minimizes total cost.