Skip to main content

Create Disclosures Run

create a disclosures run.

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

request body payload

  • GoC_data: array of objects. Group of Contracts (GoC) data.
  • run_type: string. optional. type of run. either 'test' or 'production'.
  • calculation_date: string. optional. date for the calculations. expected in the format YYYY-MM-DD.
  • first_goc_id: integer. optional filter. First GoC ID. Defaults to 1.
  • last_goc_id: integer. optional filter. Last Goc ID. Default to last GoC data object.

sample request

curl --location --request POST 'https://api.i17.actserv-africa.com/api/v2/disclosures' \
--header 'Content-Type: application/json' \
--data-raw '{
"run_type": "test",
"calculation_date": "2024-12-31",
"GoC_data": [
{
"go_c_id": 1,
"go_c_code": "1001_General_2023_NSPO",
"is_reinsurance_held": "NO",
"type_of_business": "General",
"class_of_business": "Aviation",
"sub_class": "Aviation-Hull",
"is_initial_measurement": "NO",
"grouping_criteria_1": 2023,
"grouping_criteria_2": "NSPO",
"is_investment_contract_with_dpf": "NO",
"approach_paa_gmm_vfa_mgmm": "PAA",
"base_currency": "KES",
"reporting_currency": "KES",
"gross_written_premiums": 0,
"upr_bo_p": 0,
"upr_eo_p": 0,
"claims_incurred_and_settled_over_the_period": 0,
"claims_incurred_but_not_settled_bo_p": 0,
"claims_incurred_but_not_settled_eo_p": 0,
"ibnr_bo_p": 0,
"ibnr_eo_p": 0,
"ulae_bo_p": 0,
"ulae_eo_p": 0,
"loss_component_bo_p": 0,
"loss_component_eo_p": 0,
"ra_bo_p_percent": 0,
"ra_eo_p_percent": 0,
"lic_ra_bo_p_amount": 0,
"lic_ra_eo_p_amount": 0,
"lrc_ra_bo_p_amount": 0,
"lrc_ra_eo_p_amount": 0,
"lic_non_performance_ra_bo_p": 0,
"lic_non_performance_ra_eo_p": 0,
"lrc_non_performance_ra_bo_p": 0,
"lrc_non_performance_ra_eo_p": 0,
"b_r_locked_fx_rate": 1,
"b_r_current_fx_rate": 1,
"locked_interest_rate": 0.17,
"current_interest_rate": 0.165,
"dc_bo_p_percent": 0,
"dc_eo_p_percent": 0,
"dc_bo_p_amount": 0,
"dc_eo_p_amount": 0,
"commissions_paid": 0,
"dac_bo_p": 0,
"dac_eo_p": 0,
"attributable_expenses": 0,
"epv_premiums_bo_p": 0,
"epv_premiums_eo_p": 0,
"epv_ben_exp_bo_p": 0,
"epv_ben_exp_eo_p": 0,
"os_premium_bo_p": 0,
"os_premium_eo_p": 0,
"premium_receivables_bo_p": 0,
"premium_receivables_eo_p": 0,
"other_reinsurance_payables_bo_p": 0,
"other_reinsurance_payables_eo_p": 0,
"experience_adjustments_to_lic_bo_p": 0,
"experience_adjustments_to_lic_eo_p": 0,
"experience_adjustments_to_lrc_bo_p": 0,
"experience_adjustments_to_lrc_eo_p": 0,
"csm_bo_p": 0,
"csm_adjustment_for_period": 0,
"initial_coverage_units": 0,
"current_coverage_units": 0,
"csm_amortization_for_period": 0,
"best_estimate_gmm_bo_p": 0,
"best_estimate_gmm_eo_p": 0,
"pipeline_premium": 0,
"pipeline_upr_bo_p": 0,
"pipeline_upr_eo_p": 0,
"pipeline_upr_claims_bo_p": 0,
"pipeline_upr_claims_eo_p": 0,
"pipeline_non_upr_claims_bo_p": 0,
"pipeline_non_upr_claims_eo_p": 0,
"pipeline_ra_bo_p_percent": 0,
"pipeline_ra_eo_p_percent": 0,
"pipeline_ra_bo_p_amount": 0,
"pipeline_ra_eo_p_amount": 0,
"pipeline_non_perfomance_ra_bo_p": 0,
"pipeline_non_perfomance_ra_eo_p": 0,
"pipeline_dc_bo_p_percent": 0,
"pipeline_dc_eo_p_percent": 0,
"pipeline_dc_bo_p_amount": 0,
"pipeline_dc_eo_p_amount": 0,
"pipeline_commission_paid": 0,
"pipeline_dac_bo_p": 0,
"pipeline_dac_eo_p": 0
},
{
"go_c_id": 2,
"go_c_code": "1002_General_2023_NSPO",
"is_reinsurance_held": "NO",
"type_of_business": "General",
"class_of_business": "Aviation",
"sub_class": "Aviation-Cargo",
"is_initial_measurement": "NO",
"grouping_criteria_1": 2023,
"grouping_criteria_2": "NSPO",
"is_investment_contract_with_dpf": "NO",
"approach_paa_gmm_vfa_mgmm": "PAA",
"base_currency": "KES",
"reporting_currency": "KES",
"gross_written_premiums": 0,
"upr_bo_p": 0,
"upr_eo_p": 0,
"claims_incurred_and_settled_over_the_period": 0,
"claims_incurred_but_not_settled_bo_p": 0,
"claims_incurred_but_not_settled_eo_p": 0,
"ibnr_bo_p": 0,
"ibnr_eo_p": 0,
"ulae_bo_p": 0,
"ulae_eo_p": 0,
"loss_component_bo_p": 0,
"loss_component_eo_p": 0,
"ra_bo_p_percent": 0,
"ra_eo_p_percent": 0,
"lic_ra_bo_p_amount": 0,
"lic_ra_eo_p_amount": 0,
"lrc_ra_bo_p_amount": 0,
"lrc_ra_eo_p_amount": 0,
"lic_non_performance_ra_bo_p": 0,
"lic_non_performance_ra_eo_p": 0,
"lrc_non_performance_ra_bo_p": 0,
"lrc_non_performance_ra_eo_p": 0,
"b_r_locked_fx_rate": 1,
"b_r_current_fx_rate": 1,
"locked_interest_rate": 0.17,
"current_interest_rate": 0.165,
"dc_bo_p_percent": 0,
"dc_eo_p_percent": 0,
"dc_bo_p_amount": 0,
"dc_eo_p_amount": 0,
"commissions_paid": 0,
"dac_bo_p": 0,
"dac_eo_p": 0,
"attributable_expenses": 0,
"epv_premiums_bo_p": 0,
"epv_premiums_eo_p": 0,
"epv_ben_exp_bo_p": 0,
"epv_ben_exp_eo_p": 0,
"os_premium_bo_p": 0,
"os_premium_eo_p": 0,
"premium_receivables_bo_p": 0,
"premium_receivables_eo_p": 0,
"other_reinsurance_payables_bo_p": 0,
"other_reinsurance_payables_eo_p": 0,
"experience_adjustments_to_lic_bo_p": 0,
"experience_adjustments_to_lic_eo_p": 0,
"experience_adjustments_to_lrc_bo_p": 0,
"experience_adjustments_to_lrc_eo_p": 0,
"csm_bo_p": 0,
"csm_adjustment_for_period": 0,
"initial_coverage_units": 0,
"current_coverage_units": 0,
"csm_amortization_for_period": 0,
"best_estimate_gmm_bo_p": 0,
"best_estimate_gmm_eo_p": 0,
"pipeline_premium": 0,
"pipeline_upr_bo_p": 0,
"pipeline_upr_eo_p": 0,
"pipeline_upr_claims_bo_p": 0,
"pipeline_upr_claims_eo_p": 0,
"pipeline_non_upr_claims_bo_p": 0,
"pipeline_non_upr_claims_eo_p": 0,
"pipeline_ra_bo_p_percent": 0,
"pipeline_ra_eo_p_percent": 0,
"pipeline_ra_bo_p_amount": 0,
"pipeline_ra_eo_p_amount": 0,
"pipeline_non_perfomance_ra_bo_p": 0,
"pipeline_non_perfomance_ra_eo_p": 0,
"pipeline_dc_bo_p_percent": 0,
"pipeline_dc_eo_p_percent": 0,
"pipeline_dc_bo_p_amount": 0,
"pipeline_dc_eo_p_amount": 0,
"pipeline_commission_paid": 0,
"pipeline_dac_bo_p": 0,
"pipeline_dac_eo_p": 0
},
{
"go_c_id": 3,
"go_c_code": "1003_General_2023_NSPO",
"is_reinsurance_held": "NO",
"type_of_business": "General",
"class_of_business": "Aviation",
"sub_class": "Aviation-Liability",
"is_initial_measurement": "NO",
"grouping_criteria_1": 2023,
"grouping_criteria_2": "NSPO",
"is_investment_contract_with_dpf": "NO",
"approach_paa_gmm_vfa_mgmm": "PAA",
"base_currency": "KES",
"reporting_currency": "KES",
"gross_written_premiums": 0,
"upr_bo_p": 0,
"upr_eo_p": 0,
"claims_incurred_and_settled_over_the_period": 0,
"claims_incurred_but_not_settled_bo_p": 0,
"claims_incurred_but_not_settled_eo_p": 0,
"ibnr_bo_p": 0,
"ibnr_eo_p": 0,
"ulae_bo_p": 0,
"ulae_eo_p": 0,
"loss_component_bo_p": 0,
"loss_component_eo_p": 0,
"ra_bo_p_percent": 0,
"ra_eo_p_percent": 0,
"lic_ra_bo_p_amount": 0,
"lic_ra_eo_p_amount": 0,
"lrc_ra_bo_p_amount": 0,
"lrc_ra_eo_p_amount": 0,
"lic_non_performance_ra_bo_p": 0,
"lic_non_performance_ra_eo_p": 0,
"lrc_non_performance_ra_bo_p": 0,
"lrc_non_performance_ra_eo_p": 0,
"b_r_locked_fx_rate": 1,
"b_r_current_fx_rate": 1,
"locked_interest_rate": 0.17,
"current_interest_rate": 0.165,
"dc_bo_p_percent": 0,
"dc_eo_p_percent": 0,
"dc_bo_p_amount": 0,
"dc_eo_p_amount": 0,
"commissions_paid": 0,
"dac_bo_p": 0,
"dac_eo_p": 0,
"attributable_expenses": 0,
"epv_premiums_bo_p": 0,
"epv_premiums_eo_p": 0,
"epv_ben_exp_bo_p": 0,
"epv_ben_exp_eo_p": 0,
"os_premium_bo_p": 0,
"os_premium_eo_p": 0,
"premium_receivables_bo_p": 0,
"premium_receivables_eo_p": 0,
"other_reinsurance_payables_bo_p": 0,
"other_reinsurance_payables_eo_p": 0,
"experience_adjustments_to_lic_bo_p": 0,
"experience_adjustments_to_lic_eo_p": 0,
"experience_adjustments_to_lrc_bo_p": 0,
"experience_adjustments_to_lrc_eo_p": 0,
"csm_bo_p": 0,
"csm_adjustment_for_period": 0,
"initial_coverage_units": 0,
"current_coverage_units": 0,
"csm_amortization_for_period": 0,
"best_estimate_gmm_bo_p": 0,
"best_estimate_gmm_eo_p": 0,
"pipeline_premium": 0,
"pipeline_upr_bo_p": 0,
"pipeline_upr_eo_p": 0,
"pipeline_upr_claims_bo_p": 0,
"pipeline_upr_claims_eo_p": 0,
"pipeline_non_upr_claims_bo_p": 0,
"pipeline_non_upr_claims_eo_p": 0,
"pipeline_ra_bo_p_percent": 0,
"pipeline_ra_eo_p_percent": 0,
"pipeline_ra_bo_p_amount": 0,
"pipeline_ra_eo_p_amount": 0,
"pipeline_non_perfomance_ra_bo_p": 0,
"pipeline_non_perfomance_ra_eo_p": 0,
"pipeline_dc_bo_p_percent": 0,
"pipeline_dc_eo_p_percent": 0,
"pipeline_dc_bo_p_amount": 0,
"pipeline_dc_eo_p_amount": 0,
"pipeline_commission_paid": 0,
"pipeline_dac_bo_p": 0,
"pipeline_dac_eo_p": 0
},
{
"go_c_id": 4,
"go_c_code": "1004_General_2023_NSPO",
"is_reinsurance_held": "NO",
"type_of_business": "General",
"class_of_business": "Engineering",
"sub_class": "CAR",
"is_initial_measurement": "NO",
"grouping_criteria_1": 2023,
"grouping_criteria_2": "NSPO",
"is_investment_contract_with_dpf": "NO",
"approach_paa_gmm_vfa_mgmm": "PAA",
"base_currency": "KES",
"reporting_currency": "KES",
"gross_written_premiums": 68045285.93,
"upr_bo_p": 54255806.93,
"upr_eo_p": 11285188.34,
"claims_incurred_and_settled_over_the_period": -1038742,
"claims_incurred_but_not_settled_bo_p": 5599070,
"claims_incurred_but_not_settled_eo_p": 4400538,
"ibnr_bo_p": 20299641,
"ibnr_eo_p": 12227934,
"ulae_bo_p": 327891,
"ulae_eo_p": 1264654,
"loss_component_bo_p": 10720925,
"loss_component_eo_p": 0,
"ra_bo_p_percent": 0.378,
"ra_eo_p_percent": 0.0674,
"lic_ra_bo_p_amount": 9789712.758,
"lic_ra_eo_p_amount": 1120759.0128,
"lrc_ra_bo_p_amount": 0,
"lrc_ra_eo_p_amount": 0,
"lic_non_performance_ra_bo_p": 0,
"lic_non_performance_ra_eo_p": 0,
"lrc_non_performance_ra_bo_p": 0,
"lrc_non_performance_ra_eo_p": 0,
"b_r_locked_fx_rate": 1,
"b_r_current_fx_rate": 1,
"locked_interest_rate": 0.17,
"current_interest_rate": 0.165,
"dc_bo_p_percent": 0.1262,
"dc_eo_p_percent": 0.1435,
"dc_bo_p_amount": 4503878.7956,
"dc_eo_p_amount": 2546961.7548,
"commissions_paid": 2374380.97,
"dac_bo_p": 10595294,
"dac_eo_p": 1033341.663,
"attributable_expenses": 18783454.3348,
"epv_premiums_bo_p": 0,
"epv_premiums_eo_p": 0,
"epv_ben_exp_bo_p": 0,
"epv_ben_exp_eo_p": 0,
"os_premium_bo_p": 0,
"os_premium_eo_p": 0,
"premium_receivables_bo_p": 15195762.4709,
"premium_receivables_eo_p": 8562943.5796,
"other_reinsurance_payables_bo_p": 28112787.256,
"other_reinsurance_payables_eo_p": 13659045.8938,
"experience_adjustments_to_lic_bo_p": 0,
"experience_adjustments_to_lic_eo_p": 0,
"experience_adjustments_to_lrc_bo_p": 0,
"experience_adjustments_to_lrc_eo_p": 0,
"csm_bo_p": 0,
"csm_adjustment_for_period": 0,
"initial_coverage_units": 0,
"current_coverage_units": 0,
"csm_amortization_for_period": 0,
"best_estimate_gmm_bo_p": 0,
"best_estimate_gmm_eo_p": 0,
"pipeline_premium": 0,
"pipeline_upr_bo_p": 0,
"pipeline_upr_eo_p": 0,
"pipeline_upr_claims_bo_p": 0,
"pipeline_upr_claims_eo_p": 0,
"pipeline_non_upr_claims_bo_p": 0,
"pipeline_non_upr_claims_eo_p": 0,
"pipeline_ra_bo_p_percent": 0,
"pipeline_ra_eo_p_percent": 0,
"pipeline_ra_bo_p_amount": 0,
"pipeline_ra_eo_p_amount": 0,
"pipeline_non_perfomance_ra_bo_p": 0,
"pipeline_non_perfomance_ra_eo_p": 0,
"pipeline_dc_bo_p_percent": 0,
"pipeline_dc_eo_p_percent": 0,
"pipeline_dc_bo_p_amount": 0,
"pipeline_dc_eo_p_amount": 0,
"pipeline_commission_paid": 0,
"pipeline_dac_bo_p": 0,
"pipeline_dac_eo_p": 0
},
{
"go_c_id": 5,
"go_c_code": "1005_General_2023_NSPO",
"is_reinsurance_held": "NO",
"type_of_business": "General",
"class_of_business": "Engineering",
"sub_class": "Others",
"is_initial_measurement": "NO",
"grouping_criteria_1": 2023,
"grouping_criteria_2": "NSPO",
"is_investment_contract_with_dpf": "NO",
"approach_paa_gmm_vfa_mgmm": "PAA",
"base_currency": "KES",
"reporting_currency": "KES",
"gross_written_premiums": 0,
"upr_bo_p": 0,
"upr_eo_p": 0,
"claims_incurred_and_settled_over_the_period": 0,
"claims_incurred_but_not_settled_bo_p": 0,
"claims_incurred_but_not_settled_eo_p": 0,
"ibnr_bo_p": 0,
"ibnr_eo_p": 0,
"ulae_bo_p": 0,
"ulae_eo_p": 0,
"loss_component_bo_p": 0,
"loss_component_eo_p": 0,
"ra_bo_p_percent": 0,
"ra_eo_p_percent": 0,
"lic_ra_bo_p_amount": 0,
"lic_ra_eo_p_amount": 0,
"lrc_ra_bo_p_amount": 0,
"lrc_ra_eo_p_amount": 0,
"lic_non_performance_ra_bo_p": 0,
"lic_non_performance_ra_eo_p": 0,
"lrc_non_performance_ra_bo_p": 0,
"lrc_non_performance_ra_eo_p": 0,
"b_r_locked_fx_rate": 1,
"b_r_current_fx_rate": 1,
"locked_interest_rate": 0.17,
"current_interest_rate": 0.165,
"dc_bo_p_percent": 0,
"dc_eo_p_percent": 0,
"dc_bo_p_amount": 0,
"dc_eo_p_amount": 0,
"commissions_paid": 0,
"dac_bo_p": 0,
"dac_eo_p": 0,
"attributable_expenses": 0,
"epv_premiums_bo_p": 0,
"epv_premiums_eo_p": 0,
"epv_ben_exp_bo_p": 0,
"epv_ben_exp_eo_p": 0,
"os_premium_bo_p": 0,
"os_premium_eo_p": 0,
"premium_receivables_bo_p": 0,
"premium_receivables_eo_p": 0,
"other_reinsurance_payables_bo_p": 0,
"other_reinsurance_payables_eo_p": 0,
"experience_adjustments_to_lic_bo_p": 0,
"experience_adjustments_to_lic_eo_p": 0,
"experience_adjustments_to_lrc_bo_p": 0,
"experience_adjustments_to_lrc_eo_p": 0,
"csm_bo_p": 0,
"csm_adjustment_for_period": 0,
"initial_coverage_units": 0,
"current_coverage_units": 0,
"csm_amortization_for_period": 0,
"best_estimate_gmm_bo_p": 0,
"best_estimate_gmm_eo_p": 0,
"pipeline_premium": 0,
"pipeline_upr_bo_p": 0,
"pipeline_upr_eo_p": 0,
"pipeline_upr_claims_bo_p": 0,
"pipeline_upr_claims_eo_p": 0,
"pipeline_non_upr_claims_bo_p": 0,
"pipeline_non_upr_claims_eo_p": 0,
"pipeline_ra_bo_p_percent": 0,
"pipeline_ra_eo_p_percent": 0,
"pipeline_ra_bo_p_amount": 0,
"pipeline_ra_eo_p_amount": 0,
"pipeline_non_perfomance_ra_bo_p": 0,
"pipeline_non_perfomance_ra_eo_p": 0,
"pipeline_dc_bo_p_percent": 0,
"pipeline_dc_eo_p_percent": 0,
"pipeline_dc_bo_p_amount": 0,
"pipeline_dc_eo_p_amount": 0,
"pipeline_commission_paid": 0,
"pipeline_dac_bo_p": 0,
"pipeline_dac_eo_p": 0
}
]
}'

response payload

  • code: http status of the response
  • msg: message
  • run_details: Details of the created run.

sample response

{
"code": 201,
"msg": "success",
"run_details": {
"run_id": "test__20241220____772652dc453811f081570242ac1c0002",
"run_name": "API Key Test :: test :: 2024-12-31",
"created_by": "API Key Test",
"date_and_time": "2025-06-09 13:48:46 UTC"
}
}