🥥
Highlights
The January release introduces updates to Datasources operations.

The Search EDMs operation (v1 and v2) now returns two additional EDM properties: exposureSetName and platformExposureSetId.

The Calculate Marginal Impact Report operation can now generate marginal impact analysis using four types of PLT-based analysis results as a reference analysis.

The Get Report operation now enables filtering report data by analysis ID.

The Download Report operation now returns includes marginal impact report statitics and metrics generated through user-defined workflows.
Learn More

Datasources

The Search EDMs operation (/riskmodeler/v2/datasources) now returns exposureSetName and platformExposureSetId, which enable clients to easily identify corresponding exposure sets.

An exposure set is a collection of exposure data and related analysis result data that is managed by means of an access control list (ACL). The exposure set ACL specifies the groups that may access and perform operations on exposure set data.

Property	Type	Description
`exposureSetName`	String	Name of the exposure set.
`platformExposureSetId`	Number	ID of the exposure set.

This operation can be peformed by clients with the RI-RISKMODELER and RI-UNDERWRITEIQ entitlements.

{
    "searchTotalMatch": 1,
    "searchItems": [
        {
            "datasourceName": "_Edm_DB_Original",
            "permissionType": 12,
            "isDefault": false,
            "metrics": {
                "dbsize_actual": "514048",
                "accountCount": 16,
                "size": "502 MB",
                "dataVersion": "22.0.0",
                "cedantCount": 2,
                "locationCount": 10203,
                "portfolioCount": 1,
                "treatyCount": 0,
                "edmVersion": "24",
                "aggregatedPortfolioCount": 0,
                "lastModified": "2024-12-31 08:23:40.00"
            },
            "serverState": "READY",
            "serverNamespace": "DATA_BRIDGE",
            "owner": "[email protected]",
            "exposureSetId": "6822db17-e22b-40ed-ab62-7666a5621bed",
            "createDate": "2024-12-12 08:32:53.00",
            "serverName": "databridge-2",
            "exposureSetName": "xxxxxxxxxxxxxxxx",  <-- NEW
            "platformExposureSetId": 1741005, <-- NEW
            "default": false,
            "tagIds": [
                1390
            ]
        }
    ]
}

The Search EDMs operation (/riskmodeler/v1/datasources) now returns exposureSetName and platformExposureSetId, which enable clients to easily identify corresponding exposure sets.

This operation can be peformed by clients with the RI-RISKMODELER and RI-UNDERWRITEIQ entitlements.

{
    "searchTotalMatch": 1774,
    "searchItems": [
        {
            "datasourceName": "_Edm_DB_Original",
            "permissionType": 12,
            "isDefault": false,
            "metrics": {
                "dbsize_actual": "518912",
                "accountCount": 17,
                "size": "506 MB",
                "dataVersion": "22.0.0",
                "cedantCount": 3,
                "locationCount": 10205,
                "portfolioCount": 2,
                "treatyCount": 0,
                "edmVersion": "24",
                "aggregatedPortfolioCount": 0,
                "lastModified": "2025-01-13 19:24:50.00"
            },
            "serverState": "READY",
            "serverNamespace": "DATA_BRIDGE",
            "owner": "[email protected]",
            "exposureSetId": "6822db17-e22b-40ed-ab62-xxxxxxxxxxxx",
            "createDate": "2024-12-12 08:32:53.00",
            "exposureSetName": "xxxxxxxxxxxxxxxx", <-- NEW
            "platformExposureSetId": 1741005, 
            "serverName": "xxxxxxxxxxxx",
            "default": false,
            "tagIds": [
                1390,
                1751
            ]
        }
      ]
}

Metrics

The Calculate Marginal Impact Report operations (POST /riskmodeler/v2/analyses/{id}/marginal-impact and POST /riskmodeler/v1/analyses/{id}/marginal-impact) generates a marginal impact report that measures the effect of adding additional accounts to an existing portfolio as differential losses.

Marginal impact analysis compares a portfolio-level analysis result (the reference analysis) with a new analysis that incorporates one or more account-level analysis results. The Intelligent Risk Platform calculates the difference between the reference analysis "group" and the new marginal impact "group".

In previous releases, this operation could not use PLT-based analysis as the reference analysis in the marginal impact report. This operation now supports marginal impact reports that use following reference analysis:

Supported reference analysis

This operation supports the use of portfolio-level ELT and PLT analysis results as reference analysis. ALM analysis results are not supported.

Engine	Support
DLM	Yes
DLM Group	Yes
DLM + ALM Group	No
DLM + DLM Group	Yes
DLM + HD + ALM Group	No
DLM Group + DLM Group	Yes
HD	Yes
HD Group	Yes
HD + DLM Group	Yes
HD + HD Group	Yes
Simulated PLT	Yes
ALM	No
ALM Group	No
ALM + ALM Group	No
ALM + DLM Group	No
Group of Group DLM + Group HD	No
Group of Group DLM + Group ALM	No
Group of Group HD + Group HD	No
Group of Group ALM + Group ALM	No
Group of Group ALM + Group HD	No

This operation can be peformed by clients with the RI-RISKMODELER and RI-UNDERWRITEIQ entitlements.

Reports

The Get Report operation (GET /riskmodeler/v1/reports) enables the client to return the specified UnderwriteIQ exposure summary reports.

This operation now supports filtering report data by analysisId. If specified as a query parameter, the response returns only report data for that analysis.

curl --request GET \
     --url 'https://api-euw1.rms.com/riskmodeler/v1/reports/797?analysisId=36045&datasource=88' \
     --header 'accept: application/json'

The response returns only report data for the specified analysis ID:

{
    "id": 797,
    "name": "XXXXXXXXXXXXXX : XXXXXXXXXXXXXXXXX",
    "edmName": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "createDate": "2024-12-10T08:01:25.727Z",
    "exposureId": 18,
    "exposureType": "ACCOUNT",
    "userName": "[email protected]",
    "notes": "",
    "reportDetails": [
        {
            "metricsType": "ELT",
            "analysisId": 36045,
            "reportURL": "https://XXXXXXXXXX/riskmodeler/v2/analyses/36045/elt?perspective=CL&exposureId=18&exposureType=8019",
            "additionalInfo": {
                "peril": "WS",
                "region": "NA",
                "analysisName": "XXXXXXXXXX: ACCOUNT: DEMO multi-pol"
            }
        },
        {
            "metricsType": "STATS",
            "analysisId": 36045,
            "reportURL": "https://XXXXXXXXXXXXXXXXXXXX/riskmodeler/v2/analyses/36045/stats?perspective=CL&exposureId=18&exposureType=8019",
            "additionalInfo": {
                "peril": "WS",
                "region": "NA",
                "analysisName": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX: ACCOUNT: DEMO multi-pol"
            }
        },
        {
            "metricsType": "POLICY_EP",
            "analysisId": 36045,
            "reportURL": "https://XXXXXXXXXXXXXXXXXXXX/riskmodeler/v2/analyses/36045/metrics?granularity=POLICY&metricType=EP&position=CL&returnPeriod=2&returnPeriod=5&returnPeriod=10&returnPeriod=25&returnPeriod=50&returnPeriod=100&returnPeriod=200&returnPeriod=250&returnPeriod=500&returnPeriod=1000&returnPeriod=5000&returnPeriod=10000&returnPeriod=50000&filterCondition=policyid%20in%20(22,23,24,25)&limit=1000",
            "additionalInfo": {
                "peril": "WS",
                "region": "NA",
                "analysisName": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX: ACCOUNT: DEMO multi-pol",
                "policyDetails": "[{\"id\":22,\"number\":\"EQ Policy 1\"},{\"id\":23,\"number\":\"WS Policy 1\"},{\"id\":24,\"number\":\"EQ Policy 2\"},{\"id\":25,\"number\":\"WS Policy 2\"}]"
            }
        },
        {
            "metricsType": "EP",
            "analysisId": 36045,
            "reportURL": "https://XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/v2/analyses/36045/ep?perspective=CL&exposureId=18&exposureType=8019",
            "additionalInfo": {
                "peril": "WS",
                "region": "NA",
                "analysisName": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX: ACCOUNT: DEMO multi-pol"
            }
        },
        {
            "metricsType": "POLICY_STATS",
            "analysisId": 36045,
            "reportURL": "https://XXXXXXXXXXXXXXXXXXXX/riskmodeler/v2/analyses/36045/metrics?granularity=POLICY&metricType=STATS&position=RL&offset=0&sort=policyId",
            "additionalInfo": {
                "peril": "WS",
                "region": "NA",
                "analysisName": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX: ACCOUNT: DEMO multi-pol",
                "policyDetails": "[{\"id\":22,\"number\":\"EQ Policy 1\"},{\"id\":23,\"number\":\"WS Policy 1\"},{\"id\":24,\"number\":\"EQ Policy 2\"},{\"id\":25,\"number\":\"WS Policy 2\"}]"
            }
        }
    ]
}

The Download Report operation (GET /riskmodeler/v1/reports/{id}/download) enables the client to to download specified UnderwriteIQ exposure summary reports.

This operation now automatically includes a grouped marginal impact analysis, if the user-defined workflow has included marginal impact reporting. For details, see Process User-defined Workflow. The downloaded CSV report includes the marginal impact analysis and metrics.

January 2025

🥥
Highlights

Datasources

Metrics

Supported reference analysis

Reports

🥥Highlights

Datasources

Metrics

Supported reference analysis

Reports

🥥
Highlights