Retirement income

Life expectancy & survival probabilities (SSA period life table)

Life expectancy, the survival-probability curve, milestone probabilities (reaching 80/85/90/95/100), and the median age at death — from the SSA 2021 period life table. With a second life supplied, also returns the joint (first-death) and last-survivor life expectancies. A frailty multiplier scales the death probabilities. Deterministic.

post/v1/longevity

Request

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

Request body

ageinteger required
sex'male' | 'female' required
health_adjustmentnumber

Frailty multiplier on death probabilities (<1 healthier, >1 frailer).

second_ageinteger

Second life (enables joint metrics).

second_sex'male' | 'female'
second_health_adjustmentnumber

Example request

{
  "age": 65,
  "sex": "male"
}

Response

Longevity analysis

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "lng_1a2b3c4d5e6f7a8b",
  "engine_version": "longevity-1.0.0",
  "inputs": {
    "age": 65,
    "sex": "male"
  }
}

Changes

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