Skip to main content

Calculate CSM Ratios

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

request body payload

  • policy_data: array of objects. policy data.
  • is_equal_measurement: boolean. whether measurements are equal. either true or false.

sample request

curl --location 'https://api.i17.actserv-africa.com/api/v2/csm' \
--header 'Authorization: Bearer API-KEY-goes-here' \
--data-raw '{
    "is_equal_measurement": false,
    "policy_data": [
        {
            "policy_no": "01/01/127/10608/2020",
            "end_no": "New",
            "class": "Miscellaneous",
            "sub_class": "Performance Bonds ",
            "underwriting_date": "2020-01-02",
            "policy_commencement_date": "2020-01-02",
            "policy_end_date": "2020-03-31",
            "gross_premium_amount": 1000,
            "acquisition_costs": 100
        },
        {
            "policy_no": "01/01/120/8936/2020",
            "end_no": "New",
            "class": "Miscellaneous",
            "sub_class": "Bonds (Immigration) ",
            "underwriting_date": "2020-01-02",
            "policy_commencement_date": "2020-01-02",
            "policy_end_date": "2021-01-01",
            "gross_premium_amount": 2500,
            "acquisition_costs": 250
        },
        {
            "policy_no": "01/01/120/8936/2020",
            "end_no": "05/120/6276/2020",
            "class": "Miscellaneous",
            "sub_class": "Bonds (Immigration) ",
            "underwriting_date": "2020-01-02",
            "policy_commencement_date": "2020-01-02",
            "policy_end_date": "2023-01-01",
            "gross_premium_amount": 0,
            "acquisition_costs": 0
        },
        {
            "policy_no": "01/01/020/00509/2017",
            "end_no": "05/020/6961/2020",
            "class": "Engineering",
            "sub_class": "Contractors All Risks ",
            "underwriting_date": "2020-01-01",
            "policy_commencement_date": "2020-01-01",
            "policy_end_date": "2020-02-29",
            "gross_premium_amount": 157024,
            "acquisition_costs": 31405
        },
        {
            "policy_no": "01/01/127/10601/2019",
            "end_no": "New",
            "class": "Miscellaneous",
            "sub_class": "Performance Bonds ",
            "underwriting_date": "2020-01-03",
            "policy_commencement_date": "2020-01-03",
            "policy_end_date": "2020-05-31",
            "gross_premium_amount": 2000,
            "acquisition_costs": 200
        }
    ]
}

response payload

  • code: http status of the response
  • msg: message
  • results: an object containing:
    • policy_data: validated and cleaned policy data.
    • ratios: ratios template. default values are zeros.

sample response

{
    "code": 200,
    "msg": "success",
    "results": {
        "policy_data": [
            {
                "policy_no": "01/01/127/10608/2020",
                "end_no": "New",
                "class": "Miscellaneous",
                "sub_class": "Performance Bonds ",
                "underwriting_date": "2020-01-02",
                "policy_commencement_date": "2020-01-02",
                "policy_end_date": "2020-03-31",
                "gross_premium_amount": 1000,
                "acquisition_costs": 100
            },
            {
                "policy_no": "02/01/127/10751/2020",
                "end_no": "07/127/5208/2020",
                "class": "Miscellaneous",
                "sub_class": "Performance Bonds ",
                "underwriting_date": "2020-03-13",
                "policy_commencement_date": "2020-03-13",
                "policy_end_date": "2020-08-18",
                "gross_premium_amount": 0,
                "acquisition_costs": 0
            }
        ],
        "ratios": {
            "initial_measurement": {
                "ra_ratio": [
                    {
                        "class": "Engineering",
                        "2021": 0
                    },
                    {
                        "class": "Miscellaneous",
                        "2021": 0
                    }
                ],
                "expense_ratio": [
                    {
                        "class": "Engineering",
                        "2021": 0
                    },
                    {
                        "class": "Miscellaneous",
                        "2021": 0
                    }
                ]
            }
        }
    }
}