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.

Rendered output
<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.

← All guides