Protecting your household
Three questions, three calls: how much life insurance
(/v1/insurance/life-needs), how big is the disability income gap
(/v1/insurance/disability-needs), and can you self-insure
long-term care (/v1/insurance/long-term-care). All deterministic
capital math — no product recommendations.
1 · The life-insurance capital need
A $100,000 earner, surviving spouse earning $40,000, a $250,000 mortgage, $100,000 education goal, with $250,000 of existing assets and coverage.
curl -X POST https://api.numeratica.com/v1/insurance/life-needs \
-H "Authorization: Bearer nmr_sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"annual_income": 100000, "income_replace_years": 20, "income_replace_fraction": 0.7,
"survivor_annual_income": 40000, "final_expenses": 15000, "debts": 20000,
"mortgage_balance": 250000, "education_fund": 100000,
"existing_assets": 50000, "existing_life_insurance": 200000,
"years_to_retirement": 30, "effective_tax_rate": 0.2
}'{
"result_id": "lifeneeds_fec54a1735eb5942",
"engine_version": "life-needs-1.0.0",
"result": {
"annual_income_gap": 30000, /* 70% of $100k less the survivor's $40k */
"income_replacement_need": 446324.25, /* PV of the gap over 20 years */
"final_expenses": 15000,
"debts": 20000,
"mortgage_balance": 250000,
"education_fund": 100000,
"capital_need_total": 831324.25,
"existing_resources": 250000,
"additional_coverage_needed": 581324.25,
"human_life_value": 1176026.48 /* PV-of-earnings cross-check */
},
"disclaimer": "Calculation engine output for informational purposes only; not financial or insurance advice."
}The DIME-style capital need is $831,324; net of existing resources the household should shop for about $580k of additional coverage. The human-life-value cross-check ($1.18M) brackets the answer from above.
2 · The disability gap — after tax
The subtlety advisors catch and calculators usually miss: employer-paid group LTD is
taxable. A $120,000 earner with "60% coverage" nets $4,200/month, not $6,000 —
against a $6,500 target that leaves an $800/month gap
(result.monthly_gap, result_id
disability_cdc8f70a52b954fc), a 57% real replacement ratio.
3 · Long-term care: self-insure or insure?
A 60-year-old planning for care at 82: today's $100,000/year cost inflates to
$263,365/year at the door — a $793,900 nest egg at care
start to self-insure, or a present-value cost of $334,990 today. Against a $3,000/year
policy paying $90,000/year whose 3% inflation rider compounds from purchase, insuring saves
$171,118 in present value and covers ~65% of the projected cost
(result.policy.insuring_saves_pv, result_id
ltc_7b416969a7aaafe1).
4 · Render it
The capital-needs stack — the render every life-insurance conversation starts from.
<div style="font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#1a2230;max-width:600px">
<div style="font-size:14px;color:#5b6675;margin-bottom:8px">Life-insurance capital need · $100k earner, survivor earns $40k</div>
<div style="display:grid;grid-template-columns:170px 1fr 90px;gap:6px;font-size:13px;align-items:center">
<div>Income replacement</div><div style="background:#e8edf8;border-radius:4px"><div style="width:100%;background:#1d4ed8;height:16px;border-radius:4px"></div></div><div style="text-align:right">$446,324</div>
<div>Mortgage payoff</div><div style="background:#e8edf8;border-radius:4px"><div style="width:56%;background:#1d4ed8;height:16px;border-radius:4px"></div></div><div style="text-align:right">$250,000</div>
<div>Education fund</div><div style="background:#e8edf8;border-radius:4px"><div style="width:22%;background:#1d4ed8;height:16px;border-radius:4px"></div></div><div style="text-align:right">$100,000</div>
<div>Debts + final expenses</div><div style="background:#e8edf8;border-radius:4px"><div style="width:8%;background:#1d4ed8;height:16px;border-radius:4px"></div></div><div style="text-align:right">$35,000</div>
<div style="font-weight:600">Less existing resources</div><div style="background:#e8edf8;border-radius:4px"><div style="width:30%;background:#16a34a;height:16px;border-radius:4px"></div></div><div style="text-align:right">−$250,000</div>
</div>
<div style="margin-top:12px;border:2px solid #1d4ed8;border-radius:10px;padding:12px;display:flex;justify-content:space-between;align-items:baseline">
<div style="font-weight:600">Additional coverage to shop for</div>
<div style="font-size:24px;font-weight:700">$581,324</div>
</div>
<div style="color:#5b6675;font-size:12px;margin-top:6px">result_id lifeneeds_fec54a1735eb5942 · human-life-value cross-check $1.18M · not insurance advice</div>
</div>
What the coverage is protecting against, priced:
the widow's penalty (the survivor's tax jump) and the
/v1/retirement/survivor-scenario income picture at first death.