Skip to main content

Calculate Risk Adjustment

  • method: POST
  • headers:
    • content-type: application/json
    • authorization: API Key token
  • endpoint: /risk_adjustment

request body payload

  • claims_triangles: array of objects. claims triangles data.
  • entity_type: string. type of entity. either 'Insurer' or 'Reinsurer'.
  • classification_cols: array of objects. classification columns.
  • loss_period_or_underwriting_year: string. loss period column.
  • process_distribution: string. either 'gamma' or 'od.pois'.
  • percentiles_of_interest: string. comma-separated percentiles of interest(%).

sample request

curl --location 'https://api.i17.actserv-africa.com/api/v2/risk_adjustment' \
--header 'Authorization: Bearer API-KEY-goes-here' \
--data-raw '{
"entity_type": "Insurer",
"loss_period_or_underwriting_year": "loss_period",
"percentiles_of_interest": "50, 75, 90, 95",
"process_distribution": "gamma",
"classification_cols": [
"class_of_business"
],
"claims_triangles": [
{
"class_of_business": "INPATIENT OUTPATIENT",
"loss_period": "2019-05-31",
"0": 0,
"1": 0,
"2": 0,
"3": 0,
"4": 0,
"5": 0,
"6": 0,
"7": 0,
"8": 0,
"9": 0,
"10": 0,
"11": 0,
"12": 0,
"13": 0,
"14": 0,
"15": 0,
"16": 0,
"17": 0,
"18": 0,
"19": 0,
"20": 0,
"21": 0,
"22": 0,
"23": 0,
"24": 0,
"25": 0,
"26": 0,
"27": 0,
"28": 0,
"29": 0,
"30": 0,
"31": 0,
"32": 0,
"33": 0,
"34": 0,
"35": 0,
"36": 0,
"37": 0,
"38": 0,
"39": 0,
"40": 0,
"41": 0,
"42": 0,
"43": 0,
"44": 0,
"45": 0,
"46": 0,
"47": 0,
"48": 0,
"49": 0,
"50": 0,
"51": 0,
"52": 0,
"53": 0,
"54": 0,
"55": 0,
"56": 0,
"57": 0,
"58": 0,
"59": 0,
"60": 0,
"61": 0,
"62": 0,
"63": 0,
"64": 0,
"65": 0
},
{
"class_of_business": "INPATIENT OUTPATIENT",
"loss_period": "2019-06-30",
"0": 0,
"1": 0,
"2": 0,
"3": 0,
"4": 0,
"5": 0,
"6": 0,
"7": 0,
"8": 0,
"9": 0,
"10": 0,
"11": 0,
"12": 0,
"13": 0,
"14": 0,
"15": 0,
"16": 0,
"17": 0,
"18": 0,
"19": 475,
"20": 0,
"21": 3595,
"22": 0,
"23": 171,
"24": 0,
"25": 0,
"26": 0,
"27": 0,
"28": 0,
"29": 0,
"30": 0,
"31": 0,
"32": 0,
"33": 0,
"34": 0,
"35": 0,
"36": 0,
"37": 0,
"38": 0,
"39": 0,
"40": 0,
"41": 0,
"42": 0,
"43": 0,
"44": 0,
"45": 0,
"46": 0,
"47": 0,
"48": 0,
"49": 0,
"50": 0,
"51": 0,
"52": 0,
"53": 0,
"54": 0,
"55": 0,
"56": 0,
"57": 0,
"58": 0,
"59": 0,
"60": 0,
"61": 0,
"62": 0,
"63": 0,
"64": 0
}
]
}'

response payload

  • code: http status of the response
  • msg: message
  • risk_adjustment: an object containing the risk adjustment results:
    • predictive_distribution_of_reserves
    • risk_adjustment

sample response

{
"code": 200,
"msg": "success",
"risk_adjustment": {
"predictive_distribution_of_reserves": [
{
"class_of_business": "ACCIDENT",
"loss_period": "2014-03-31",
"Latest": 16279500,
"Mean Ultimate": 16279500,
"Mean IBNR": 0,
"SD IBNR": 0,
"IBNR 50%": 0,
"IBNR 75%": 0,
"IBNR 90%": 0,
"IBNR 95%": 0,
"Ultimate 50%": 16279500,
"Ultimate 75%": 16279500,
"Ultimate 90%": 16279500,
"Ultimate 95%": 16279500
},
{
"class_of_business": "WORKMEN'S COMPENSATION",
"loss_period": "2021-09-30",
"Latest": 780001,
"Mean Ultimate": 2605496.8716,
"Mean IBNR": 1825495.8716,
"SD IBNR": 3350300.8369,
"IBNR 50%": 908978.7491,
"IBNR 75%": 2968345.322,
"IBNR 90%": 5813912.421,
"IBNR 95%": 8479495.0099,
"Ultimate 50%": 1688979.7491,
"Ultimate 75%": 3748346.322,
"Ultimate 90%": 6593913.421,
"Ultimate 95%": 9259496.0099
}
],
"risk_adjustment": [
{
"class_of_business": "ACCIDENT",
"Latest": 430304826.32,
"Mean Ultimate": 442411739.5194,
"Mean IBNR": 12106913.1994,
"IBNR 50%": 3019241.4289,
"IBNR 75%": 13288669.6628,
"IBNR 90%": 37302478.447,
"IBNR 95%": 60273758.329,
"Ultimate 50%": 433324067.7489,
"Ultimate 75%": 443593495.9828,
"Ultimate 90%": 467607304.767,
"Ultimate 95%": 490578584.649,
"Risk Adjustment 50%": -9087671.7705,
"Risk Adjustment 75%": 1181756.4634,
"Risk Adjustment 90%": 25195565.2476,
"Risk Adjustment 95%": 48166845.1296,
"% Ratio Risk Adjustment 50%": -0.7506,
"% Ratio Risk Adjustment 75%": 0.0976,
"% Ratio Risk Adjustment 90%": 2.0811,
"% Ratio Risk Adjustment 95%": 3.9785
},
{
"class_of_business": "WORKMEN'S COMPENSATION",
"Latest": 1114543494.29,
"Mean Ultimate": 1157497928.4021,
"Mean IBNR": 42954434.1121,
"IBNR 50%": 32722483.6678,
"IBNR 75%": 57695223.3603,
"IBNR 90%": 90576715.814,
"IBNR 95%": 117743679.5004,
"Ultimate 50%": 1147265977.9578,
"Ultimate 75%": 1172238717.6503,
"Ultimate 90%": 1205120210.104,
"Ultimate 95%": 1232287173.7904,
"Risk Adjustment 50%": -10231950.4443,
"Risk Adjustment 75%": 14740789.2482,
"Risk Adjustment 90%": 47622281.7019,
"Risk Adjustment 95%": 74789245.3882,
"% Ratio Risk Adjustment 50%": -0.2382,
"% Ratio Risk Adjustment 75%": 0.3432,
"% Ratio Risk Adjustment 90%": 1.1087,
"% Ratio Risk Adjustment 95%": 1.7411
}
]
}
}