API Reference

Convert event rates and losses

post
https://{host}/platform/riskdata/v1/analyses//convert-event-rate-loss

Generates a new analysis result based on an existing portfolio-level EP result by applying event rate or event loss adjustments to the specified reference analysis.

Analysis jobs generally require substantial time and resources to complete. Event rate conversion enables cat modelers to compare analysis results based on different event rates without re-running the analysis jobs from scratch.

Event rate adjustments

Event rate adjustments enable you to compare results using different event rates. The event loss rate defines the annual probability of that event occurring.

The eventRateSchemeIds attribute accepts an array of event rate schemes identified by ID number. If unspecified, the service returns event loss adjustments only.

Event loss adjustments

Event loss adjustments enable you to scale mean losses and uncertainty to align with your organization's view of risk.

The eventLossAdjustmentSchemeIds attribute accepts an array of event loss adjustment schemes.If unspecified, the service returns event rate adjustments only.

Once the job is complete, the service writes the upated analysis results to the RDM using new analysis ID and a name that appends the string _EVENT to the name of the original analysis result.

🍊

Postman Collection

Moody's Insurance Solutions makes sample code available in a Postman Collection that you can download from the RMS Developers public workspace.

The Convert Event Rates & Apply Loss Adjustments Postman collection demonstrates a workflow that converts event rates and losses based on an updated event rate scheme and event adjustment scheme.

🪰

Entitlements

RI-EXPOSUREIQ RI-RISKMODLER RI-UNDERWRITEIQ

Headers
uuid
required
Defaults to xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

ID of resource group. To learn more, see Resource Groups

Path Params
int64
required
≥ 1

ID of EP analysis result to recalculate.

Body Params
string
length between 0 and 64

Name of analysis result. Valid characters: 0-9, A-Z, a- z, underscore (_), hyphen (-), colon (:), and blank space. Cannot start or end with hyphen, space, or colon. Cannot include consecutive hyphens (--). Maximum length 80 characters.

eventRateSchemeIds
array of int32s

List of event rate schemes by ID.

eventRateSchemeIds
eventLossAdjustmentSchemeIds
array of int32s

List of event loss adjustment schemes by ID.

eventLossAdjustmentSchemeIds
boolean
Defaults to false

If true, overrides eventIds in the analysis with externalIds from event rate schemes

Responses

CONVERT_EVENT_RATE_LOSS job has been added to the job queue for processing.

Updated 6 months ago

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
*/*
application/json

Updated 6 months ago