Business simulation games →
Play 8 business roles, predict consequences, compare paths and download your decision reviews.
Bring mortgage estimates, rental analysis and business-listing checks into your own app. Powered by the same calculation models as our free tools.
OpenAPI 3.1 specification ↗ Use the calculators
/api/v1/calculators/mortgage, /rental-property or /business under the same prefix. Every documented field is required. Unknown fields and numeric strings are rejected.Retry-After interval and use backoff; do not retry in a tight loop.Existing website calculators continue to calculate in the visitor’s tab. They do not send visitor inputs to this API.
This sends the documented sample numbers to the API. No account or key required.
POST /api/v1/calculators/mortgage
Monthly payment components, loan fees and cash needed. Fixed fully amortizing loans only; USDA Guaranteed requires a 30-year term.
curl https://losttofound.org/api/v1/calculators/mortgage \
-H 'Content-Type: application/json' \
--data '{
"price": 350000,
"downPercent": 10,
"rate": 6.71,
"years": 30,
"loanType": "conventional",
"vaUse": "first",
"financeFee": true,
"taxPercent": 1.1,
"annualInsurance": 1800,
"monthlyHoa": 0,
"pmiPercent": 0.5,
"maintenancePercent": 1,
"closingPercent": 3,
"extraCash": 1500,
"reserveMonths": 3,
"savings": 0,
"grossIncome": 0,
"monthlyDebts": 0,
"customUpfrontFee": 0,
"customMonthlyInsurance": 0
}'| Field | Type / bounds | Meaning |
|---|---|---|
price | number · 1 to 10000000 | price |
downPercent | number · 0 to 100 | down percent |
rate | number · 0 to 30 | User-supplied annual interest rate in percentage points. No rate lookup or lender quote is performed. |
years | integer · 1 to 40 | Fully amortizing fixed-rate years; USDA must be 30. |
loanType | conventional, fha, va, usda, jumbo, other | loan type |
vaUse | first, subsequent, exempt | va use |
financeFee | boolean | finance fee |
taxPercent | number · 0 to 100 | tax percent |
annualInsurance | number · 0 to 1000000000 | annual insurance |
monthlyHoa | number · 0 to 1000000000 | monthly hoa |
pmiPercent | number · 0 to 100 | pmi percent |
maintenancePercent | number · 0 to 100 | maintenance percent |
closingPercent | number · 0 to 100 | closing percent |
extraCash | number · 0 to 1000000000 | extra cash |
reserveMonths | number · 0 to 120 | reserve months |
savings | number · 0 to 1000000000 | savings |
grossIncome | number · 0 to 1000000000 | gross income |
monthlyDebts | number · 0 to 1000000000 | monthly debts |
customUpfrontFee | number · 0 to 1000000000 | custom upfront fee |
customMonthlyInsurance | number · 0 to 1000000000 | custom monthly insurance |
Dollar fields use annual amounts unless their name starts with “monthly”, or they are a price, balance, fee, savings or cash amount. See model assumptions in the response. Business ownerPay, labor, reinvestment and annualDebt are annual; rental rent, other, HOA and utilities are monthly.
{
"apiVersion": "v1",
"calculationVersion": "2026-09-07.1",
"model": "mortgage",
"currency": "USD",
"result": {
"down": 35000,
"baseLoan": 315000,
"feePercent": 0,
"fundingFee": 0,
"loan": 315000,
"principalInterest": 2034.7155423173795,
"tax": 320.83333333333337,
"insurance": 150,
"pmi": 131.25,
"monthlyInsurance": 131.25,
"annualInsurancePercent": 0,
"insuranceLabel": "Mortgage insurance (PMI)",
"upfrontFeeLabel": "VA funding fee",
"insuranceDuration": "PMI is an initial estimate; cancellation rules and lender terms determine when it ends.",
"housing": 2636.798875650713,
"maintenance": 291.6666666666667,
"monthly": 2928.4655423173795,
"closing": 10500,
"cashFee": 0,
"upfront": 47000,
"reserves": 8785.396626952139,
"cashTarget": 55785.39662695214,
"gap": 55785.39662695214,
"debtToIncome": null,
"totalInterest": 417497.5952342566
},
"assumptions": [
"User-supplied rate; no live quote or eligibility check.",
"All dollar amounts are USD; rate and percentage fields use percentage points, not fractions.",
"Fixed fully amortizing loan; mortgage insurance is an initial estimate.",
"Taxes, insurance, closing costs and upkeep are supplied assumptions."
],
"sources": [
"https://www.consumerfinance.gov/owning-a-home/",
"https://www.hud.gov/buying/loans",
"https://www.va.gov/housing-assistance/home-loans/"
],
"disclaimer": "Educational estimate, not a quote, appraisal, approval or personalized financial advice."
}POST /api/v1/calculators/rental-property
Rental NOI, cash flow, cap rate, cash-on-cash return and downside. All operating income and cost assumptions are supplied by the caller.
curl https://losttofound.org/api/v1/calculators/rental-property \
-H 'Content-Type: application/json' \
--data '{
"price": 350000,
"down": 20,
"rate": 7,
"term": 30,
"closing": 3,
"rehab": 10000,
"reserves": 10000,
"rent": 2800,
"other": 0,
"vacancy": 5,
"tax": 4200,
"insurance": 1800,
"hoa": 0,
"utilities": 100,
"repairs": 2000,
"capex": 2000,
"management": 8
}'| Field | Type / bounds | Meaning |
|---|---|---|
price | number · 1 to 1000000000 | Purchase price ($) |
down | number · 0 to 100 | Down payment (%) |
rate | number · 0 to 30 | Annual loan interest rate (%). Illustrative fixed rate; use a lender quote. |
term | integer · 1 to 40 | Mortgage term (years) |
closing | number · 0 to 100 | Purchase closing costs (%) |
rehab | number · 0 to 1000000000 | Initial repairs / renovation ($) |
reserves | number · 0 to 1000000000 | Initial cash reserves ($) |
rent | number · 0 to 1000000000 | Monthly scheduled rent (all units) ($) |
other | number · 0 to 1000000000 | Monthly other income ($) |
vacancy | number · 0 to 99 | Vacancy / uncollected income (%) |
tax | number · 0 to 1000000000 | Annual property taxes ($) |
insurance | number · 0 to 1000000000 | Annual property insurance ($) |
hoa | number · 0 to 1000000000 | Monthly HOA ($) |
utilities | number · 0 to 1000000000 | Monthly owner-paid utilities / other costs ($) |
repairs | number · 0 to 1000000000 | Annual routine repairs ($) |
capex | number · 0 to 1000000000 | Annual capital replacement reserve ($) |
management | number · 0 to 99 | Management fee on collected income (%) |
Dollar fields use annual amounts unless their name starts with “monthly”, or they are a price, balance, fee, savings or cash amount. See model assumptions in the response. Business ownerPay, labor, reinvestment and annualDebt are annual; rental rent, other, HOA and utilities are monthly.
{
"apiVersion": "v1",
"calculationVersion": "2026-09-07.1",
"model": "rental-property",
"currency": "USD",
"result": {
"headline": "This property needs cash each month",
"metrics": [
{
"label": "Monthly cash flow",
"value": -348.98031983504615,
"format": "money"
},
{
"label": "Cash needed to buy",
"value": 100500,
"format": "money"
},
{
"label": "Cap rate",
"value": 5.7618285714285715,
"format": "percent"
},
{
"label": "Cash-on-cash return",
"value": -4.166929192060252,
"format": "percent"
}
],
"rows": [
{
"label": "Scheduled annual income",
"value": 33600,
"format": "money"
},
{
"label": "Vacancy allowance",
"value": 1680,
"format": "money"
},
{
"label": "Operating expenses",
"value": 11753.6,
"format": "money"
},
{
"label": "Net operating income (NOI)",
"value": 20166.4,
"format": "money"
},
{
"label": "Capital replacement reserve",
"value": 2000,
"format": "money"
},
{
"label": "Annual mortgage payments",
"value": 22354.163838020555,
"format": "money"
},
{
"label": "NOI / debt service",
"value": 0.9021317078163511,
"format": "ratio"
},
{
"label": "Monthly rent needed to break even",
"value": 3199.2909837929587,
"format": "money"
},
{
"label": "Downside monthly cash flow",
"value": -709.6203198350462,
"format": "money"
}
],
"notes": [
"NOI excludes financing, income taxes and capital replacements. Cash flow includes your capital reserve. No appreciation or tax benefits are assumed.",
"Downside: scheduled rent and other income fall 10%, vacancy rises 5 percentage points, and fixed expenses remain unchanged.",
"Verify actual rent rolls, property taxes after sale, insurance quotes, local rules, repairs and vacancy. Rates and costs are editable assumptions, not investment-loan quotes."
]
},
"assumptions": [
"USD; rent, other, HOA and utilities are monthly. Tax, insurance, repairs and capex are annual.",
"Vacancy and management are percentages; down and closing are percentages of price.",
"Before income taxes, appreciation and depreciation benefits.",
"Downside reduces scheduled income 10% and raises vacancy 5 percentage points."
],
"sources": [
"https://www.consumerfinance.gov/owning-a-home/prepare/figure-out-how-much-you-want-to-spend/",
"https://www.irs.gov/publications/p527"
],
"disclaimer": "Educational estimate, not a quote, appraisal, approval or personalized financial advice."
}POST /api/v1/calculators/business
SDE / EBITDA range, acquisition financing, debt coverage and buyer cash. Assumed debt requires a positive annual payment schedule; deferred debt is outside this beta.
curl https://losttofound.org/api/v1/calculators/business \
-H 'Content-Type: application/json' \
--data '{
"price": 450000,
"revenue": 900000,
"earnings": 180000,
"basis": "sde",
"unsupported": 15000,
"labor": 0,
"reinvestment": 15000,
"ownerPay": 60000,
"debt": 0,
"acquiredCash": 0,
"annualDebt": 0,
"down": 20,
"rate": 10,
"years": 10,
"costs": 15000,
"workingCapital": 30000,
"low": 2,
"high": 3,
"decline": 20,
"target": 1.25,
"assets": 0
}'| Field | Type / bounds | Meaning |
|---|---|---|
price | number · 1 to 10000000 | price |
revenue | number · 0 to 1000000000 | revenue |
earnings | number · -1000000000 to 1000000000 | earnings |
basis | sde, ebitda | basis |
unsupported | number · 0 to 1000000000 | unsupported |
labor | number · 0 to 1000000000 | labor |
reinvestment | number · 0 to 1000000000 | reinvestment |
ownerPay | number · 0 to 1000000000 | owner pay |
debt | number · 0 to 1000000000 | debt |
acquiredCash | number · 0 to 1000000000 | acquired cash |
annualDebt | number · 0 to 1000000000 | Annual principal plus interest on assumed debt. Must be positive when debt is positive; deferred-payment debt is outside this beta. |
down | number · 0 to 100 | down |
rate | number · 0 to 100 | rate |
years | integer · 1 to 30 | Acquisition loan amortization years. |
costs | number · 0 to 1000000000 | costs |
workingCapital | number · 0 to 1000000000 | working capital |
low | number · 0 to 30 | low |
high | number · 0 to 30 | high |
decline | number · 0 to 100 | decline |
target | number · 1 to 100 | target |
assets | number · 0 to 1000000000 | assets |
Dollar fields use annual amounts unless their name starts with “monthly”, or they are a price, balance, fee, savings or cash amount. See model assumptions in the response. Business ownerPay, labor, reinvestment and annualDebt are annual; rental rent, other, HOA and utilities are monthly.
{
"apiVersion": "v1",
"calculationVersion": "2026-09-07.1",
"model": "business",
"currency": "USD",
"result": {
"normalized": 165000,
"operatingPrice": 450000,
"lowValue": 330000,
"highValue": 495000,
"loan": 360000,
"payment": 4757.42652774342,
"debtService": 57089.11833292103,
"available": 150000,
"residual": 92910.88166707897,
"surplus": 32910.88166707897,
"coverage": 2.6274709503352227,
"stressCoverage": 2.0494273412614734,
"stressedResidual": -89.11833292103256,
"cashNeeded": 135000,
"earningsMultiple": 2.727272727272727,
"revenueMultiple": 0.5,
"margin": 18.333333333333332,
"leverage": 2.1818181818181817,
"cashReturn": 24.37843086450294,
"assetEquity": 0,
"pricePosition": "Within your selected range"
},
"assumptions": [
"All dollars are USD and cash-flow inputs are annual unless specified.",
"User-selected SDE or EBITDA multiples; no appraisal or automatic comparable-deal lookup.",
"One fully amortizing acquisition loan; transferred debt payments are supplied separately.",
"No tax, balloon, refinancing or lender eligibility model."
],
"sources": [
"https://www.bizbuysell.com/insight-report-data-tables/",
"https://www.sba.gov/loans/7a-loans/"
],
"disclaimer": "Educational estimate, not a quote, appraisal, approval or personalized financial advice."
}Errors are JSON: {"error":{"code":"invalid_input","message":"…"}}. Expect 400 for malformed JSON or query parameters, 405 for unsupported methods, 408 for slow bodies, 413 for size, 415 for content type, 422 for inputs, 429 for rate limits and 503 for temporary unavailability. Never display a failed request as a zero-dollar estimate.
Return assumptions and source links alongside results, and identify unavailable values rather than converting null to zero. These are educational estimates, not loan quotes, appraisals, approvals or personalized advice.
Older students can compare a hand calculation, the browser calculator and an API response using fictional inputs. Explore calculator lesson plans and activities →
Play 8 business roles, predict consequences, compare paths and download your decision reviews.
Make a prediction, change an assumption and explain the result using fictional numbers and printable response sheets.
Start with a goal: buy a home, evaluate a business, manage debt, compare jobs or teach money skills.