Life insurance need (DIME) API

Compute recommended life-insurance coverage with the canonical DIME method (Debt + Income replacement + Mortgage + Education), net of existing coverage and liquid assets, with a per-factor breakdown. Deterministic coverage math advisors/agents get wrong. Answers 'how much life insurance do I need', 'DIME coverage estimate', 'life insurance gap', 'recommended death benefit'.

Price$0.01per request

MethodPOST

Route/v1/calc/ins-life-insurance-need

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcinsurancelifedimecoverageactuarialneedplanning

API URLhttps://x402.hexl.dev/v1/calc/ins-life-insurance-need

Integration docs

Example request

{
  "debt": 20000,
  "annualIncome": 80000,
  "incomeYears": 10,
  "mortgageBalance": 250000,
  "educationCost": 100000,
  "existingCoverage": 100000
}

Example response

{
  "method": "DIME",
  "grossNeed": 1185000,
  "offsets": {
    "existingCoverage": 100000,
    "liquidAssets": 0
  },
  "recommendedCoverage": 1085000,
  "coverageGap": 1085000,
  "breakdown": [
    {
      "factor": "D — Debt + final expenses",
      "amount": 35000
    },
    {
      "factor": "I — Income replacement",
      "amount": 800000
    },
    {
      "factor": "M — Mortgage balance",
      "amount": 250000
    },
    {
      "factor": "E — Education costs",
      "amount": 100000
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "annualIncome"
  ],
  "properties": {
    "debt": {
      "type": "number",
      "examples": [
        20000
      ],
      "description": "non-mortgage debt (USD)"
    },
    "finalExpenses": {
      "type": "number",
      "examples": [
        15000
      ],
      "description": "default 15000 (USD)"
    },
    "annualIncome": {
      "type": "number",
      "examples": [
        80000
      ],
      "description": "income to replace (USD/yr)"
    },
    "incomeYears": {
      "type": "number",
      "examples": [
        10
      ],
      "description": "years of income to replace, default 10"
    },
    "mortgageBalance": {
      "type": "number",
      "examples": [
        250000
      ]
    },
    "educationCost": {
      "type": "number",
      "examples": [
        100000
      ]
    },
    "existingCoverage": {
      "type": "number",
      "examples": [
        100000
      ]
    },
    "liquidAssets": {
      "type": "number",
      "examples": [
        0
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}