How-To


Life expectancy

  • Bob is male and was born on 01/01/1965
  • His partner, Jane, is female was born on 01/06/1968
  • Bob and Jane would like to know how long they are likely to live in order to plan for retirement.
  • They would like to know their individual and combined life expectancies if they retired on 01/01/2030 with a 5%, 50% and 95% probability.

Request

{
  "user": {
    "dateOfBirth": "1965-01-01",
    "gender": "MALE",
    "spouse": {
      "dateOfBirth": "1968-06-01",
      "gender": "FEMALE"
    }
  },
  "forecastOptions": {
    "percentiles": [
      5,
      50,
      95
    ],
    "retirementDate": "2030-01-01",
    "taxOptions": {
      "region": "UK"
    }
  }
}

Response

  • There is a 95% probability that one of Bob or Jane would live until age 85. Individually there is a 95% probability of Bob being alive at age 72 and Jane being alive at 73.
  • There is a 50% probability that one of Bob or Jane would live until age 99. Individually there is a 50% probability of Bob being alive at age 91 and Jane being alive at 93.
  • There is a 5% probability that one of Bob or Jane would live until age 109. Individually there is a 5% probability of Bob being alive at age 104 and Jane being alive at 106.
{
    "results": [
        {
            "probability": 95,
            "user": 72,
            "spouse": 73,
            "combined": 85
        },
        {
            "probability": 50,
            "user": 91,
            "spouse": 93,
            "combined": 99
        },
        {
            "probability": 5,
            "user": 104,
            "spouse": 106,
            "combined": 109
        }
    ]
}