Insurance

Disability-income protection gap analysis

Sizes the gap between the income a household needs if the earner is disabled and what existing coverage pays after tax. Its main value is netting benefits correctly: an employer-paid group LTD benefit is taxable, so "60% of pay" nets far less at a given marginal rate, while an individually-owned (after-tax) policy pays tax-free. Reports the monthly target (a replacement fraction of income, or an essential-expense floor), the net value of group / individual / SSDI benefits, the remaining monthly gap and the additional benefit to buy, plus the current replacement ratio. Deterministic; not insurance advice.

post/v1/insurance/disability-needs

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/insurance/disability-needs
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

gross_annual_incomenumber required

The income to protect.

target_replacement_fractionnumber

Share of gross income to replace. Omit for 0.65.

essential_monthly_expensesnumber

When > 0, overrides the fractional target with a monthly floor.

employer_group_fractionnumber

Fraction of income the group LTD plan replaces (e.g. 0.60).

employer_group_monthly_maxnumber

Group benefit cap (0 = uncapped).

employer_paid_premiumboolean

True ⇒ the group benefit is taxable.

marginal_tax_ratenumber

Applied to any taxable benefit.

individual_monthly_benefitnumber

Individually-owned policy benefit (tax-free).

ssdi_monthly_benefitnumber

Estimated SSDI monthly benefit (treated as tax-free).

ssdi_offsets_groupboolean

Whether the group LTD contract reduces its benefit dollar-for-dollar by SSDI (the common 'other income' offset). Default true; set false for a rare non-offsetting plan or when there is no group coverage.

Response

The protection-gap analysis

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "disability_1a2b3c4d5e6f7a8b",
  "engine_version": "disability-1.0.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.