Calculates marginal impact analysis that measures the effect of adding additional accounts to an existing portfolio as differential losses.
Marginal impact analysis compares a portfolio-level analysis result 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".
The required analysisid path parameter specifies the ID of the reference analysis, a portfolio-level, ELT- or PLT-based analysis. The required marginalImpactAnalysisIds body parameter defines an array of account-level analysis results. For each analysis result, the operation returns differential losses that represent the difference between the original portfolio metrics with those of the updated portfolio that includes the account metrics.
Once the MARGINAL_IMPACT job is complete, the operation adds an result with a new ID and a name that appends the string _MI to the name of the 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 |
Batch Workflows
The Batch Job operation enables UnderwriteIQ clients to initiate complex underwriting workflows with single request.
This user-defined workflow consists of a series of tasks that are processed in the specified order. The Calculate Marginal Impact operation is one of the operations that can be specified in the body of a batch job.
For example, a batch job can define a workflow that consists of multiple tasks that perform the following operations in sequence: 1) create new accounts, 2) geocode account locations, 3) model those accounts, 4) calculate marginal impact, 5) .
Postman Collection
Moody's Insurance Solutions makes sample code available in a Postman Collection that you can download from the RMS Developers public workspace: Batch Workflow (UIQ) with Marginal Impact
Permissions
To perform this operation, a principal must belong to a group that has been assigned the appropriate role-based permissions. The table identifies the roles with permission to perform this operation.
Underwriter Technical Underwriter Risk Analyst Portfolio Manager Cat Modeler NO YES YES YES YES To learn more about role-based permissions in the Platform APIs, see Groups and Roles.
Entitlements
RI-UNDERWRITEIQ
/platform/riskdata/v1/analyses/{analysisId}/marginal-impact HD_MARGINAL_IMPACT MARGINAL_IMPACT marginalImpactAnalysisIds marginalimpact output level outputLevel