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 (based on reference portfolio) with a new analysis that incorporates analysis results for one or more accounts. The report returns metrics that illustrate differential losses (as amounts and percentages) between those based on the reference portfolio and those based on the updated portfolio.
The required id 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.
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 |
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.
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 Risk Modeler or UnderwriteIQ, see Groups and Roles.