2025.07b

đŸ„„

Highlights

The July release introduces updates to the Exchange Data API, Legacy API, Variation API, and Moody's Insurance Solutions Developer Portal access controls.

  • Batch API: Adds support for converting event rates and losses in user-defined workflows.
  • Exchange Data API: Adds support for managing share requests, a method for securely sharing exposure or analysis data.
  • Export API: Adds support uploading Version 25 EDM and RDM databases.
  • Legacy API: Adds support for managing batch templates for creating UnderwriteIQ reports and improved support for the modeling locations and policies covered by facultative cessions using HD models.
  • Risk Data API: Adds support for calculating climate change analyses as a post-analysis action using SSP scenarios and the ability to retrieve EP metrics and key loss statistics for TreatyIQ rollup analyses.
  • Variations API: Now accepts an optional riskViews parameter, which determines whether risk-by-peril data is provided for the portfolio variations created in the request.
    Learn More

Developer Portal Access Controls

The Moody's Insurance Solutions Developer Portal now requires that all visitors log in using an Intelligent Risk Platform user account and credentials.

Every Intelligent Risk Platform developer that requires access to the developer portal will need their own user account and login credentials. Licensed users can log into the Moody's Insurance Solutions Developer Portal using their email address and password.

Contact your Intelligent Risk Platform client success manager for more information.

Admin Data

Search Archives

The Search Archives operation ( GET /platform/admindata/v1/archives/) returns a list of archives.

This operation now returns the archivedBy property that identifies the principal that created the archive.

Responses can be filtered and sorted by archivedBy values.

PropertyTypeComparisonList
archivedByString=, !=, LIKE, NOT LIKEIN,NOT IN

Get Archive

The Get Archive operation ( GET /platform/admindata/v1/archives/{archiveId}) returns the specified archive.

This operation now returns the archivedBy property that identifies the principal that created the archive.

Batch API

The Create Batch Job operation ( POST /platform/batch/v1/jobs/) initiates a batch job that manages the processing of multiple operations in a workflow.

This operation now enables the client to submit requests for batch jobs that include the Convert Event Rate Losses operation as a task within the workflow.

In addition to the Create Event Rate Losses, the following operations can be defined as tasks in a batch job: Create Export Job, Create Geohaz Job, Create Grouping Job, Create Model Job, Create Marginal Impact, Recalculate with PATE, Convert Event Rates and Losses, Create Risk Data Report, Create Bulk Edit Job.

All operations are defined in the body of the request package. These operations are known as tasks within the workflow. Each task is defined as a JSON object in the request package and processed as a separate job by the workflow engine.

Exchange Data API

Create Share Request

The Create Share Request operation ( POST /platform/exchangedata/v1/sharekeys/{shareKey} /sharerequests) now creates share requests that share multiple exposures or analysis results.

A share request is a request to make exposure or analysis data available to a recipient. Every share request is identified by a share key, which enables a specific recipient to access the data.

This operation now accepts a resourceMap parameter that maps shared exposures and analyses. This mapping enables the client application to identify analyses that are based upon particular exposures.

{
  "shareRequestName": "group share",
  "recipientShareKey": "HS6FOPYSRP",
  "recipientEmail": "",
  "comment": "",
  "resources": [
    {
      "resourceType": "EXPOSURE",
      "resourceUris": [
        "/platform/riskdata/v1/exposures/13694811",
        "/platform/riskdata/v1/exposures/13693834",
        "/platform/riskdata/v1/exposures/55555" //This exposure does not have any Analysis associated with it
      ]
    },
    {
      "resourceType": "ANALYSIS",
      "resourceUris": [
        "/platform/riskdata/v1/analyses/16931626",
        "/platform/riskdata/v1/analyses/16932326",
        "/platform/riskdata/v1/analyses/12345",
        "/platform/riskdata/v1/analyses/1111" //Analysis 1111 is not associated with any Exposure
      ],
      "resourceMap": [
        {
          "exposureId": 13694811,
          "analysisIds": [
            16931626, //Associated with exposureId = 13694811
            16932326
          ]
        },
        {
          "exposureId": 13693834,
          "analysisIds": [
            12345 //Associated with exposureId = 13693834
          ]
        }
      ]
    }
  ]
}

The resourceMap defines an array of objects that map analyses (specified in the ANALYSIS resource type object) to exposures (specified in the EXPOSURES resource type object).

Get Share Request

The Get Share Request operation (GET /platform/exchangedata/v1/sharekeys/{shareKey}/sharerequests /sharerequest/{id}) now returns information about mappings between shared exposures and analyses.

The resourceType object returns additional information about the share request:

  • EXPOSURE resource type objects now return the edmVersion in each resourceProperties` object.
  • ANALYSIS resource type objects now return the analysisEngineType and analysisFrameworkproperties (e.g. ELT, PLT) in each resourceProperties object.
[
    {
        "shareRequestId": 3468,
        "shareRequestName": "group share",
        "shareKey": "LDG07QLRCR",
        "shareKeyName": "sharekey 2024",
        "recipientShareKey": "HS6FOPYSRP",
        "recipientShareKeyName": "Celtic Re",
        "status": "Accepted",
        "createdBy": "[email protected]",
        "recipientEmail": "",
        "updatedBy": "[email protected]",
        "createdAt": "2025-03-20T14:50:24.639246Z",
        "updatedAt": "2025-03-20T14:50:44.305511Z",
        "comment": "",
        "shareRequestType": "OUTBOUND",
        "isPackage": true,
        "resources": [
            {
                "resourceType": "ANALYSIS",
                "resourceSize": "0 bytes",
                "resourceUris": [
                    "/platform/riskdata/v1/analyses/16932326",
                    "/platform/riskdata/v1/analyses/16931626"
                ],
                "resourceProperties": [
                    {
                        "resourceUri": "/platform/riskdata/v1/analyses/16932326",
                        "resourceName": "Ami_180_1",
                        "resourceSize": "0 bytes",
                        "exposureName": "dabase67",
                        "analysisFramework": "ELT",
                        "analysisType": "EP",
                        "analysisEngineType": "DLM",
                        "exposureId": 13694811
                    },
                    {
                        "resourceUri": "/platform/riskdata/v1/analyses/16931626",
                        "resourceName": "RMS_RL18_Ref_TestData_EDM_4",
                        "resourceSize": "0 bytes",
                        "exposureName": "dabase67",
                        "analysisFramework": "PLT",
                        "analysisType": "EP",
                        "analysisEngineType": "HD",
                        "exposureId": 13694811
                    }
                ]
            },
            {
                "resourceType": "EXPOSURE",
                "resourceSize": "156 MB",
                "resourceUris": [
                    "/platform/riskdata/v1/exposures/13694811",
                    "/platform/riskdata/v1/exposures/13693834"
                ],
                "resourceProperties": [
                    {
                        "resourceUri": "/platform/riskdata/v1/exposures/13694811",
                        "resourceName": "dabase67",
                        "resourceSize": "78 MB",
                        "edmVersion": "24"
                    },
                    {
                        "resourceUri": "/platform/riskdata/v1/exposures/13693834",
                        "resourceName": "database3",
                        "resourceSize": "78 MB",
                        "edmVersion": "24"
                    }
                ]
            }
        ]
    },

Review Share Request

The Review Share Request operation (POST /platform/exchangedata/v1/sharekeys/{shareKey} /sharerequests/{shareRequestId}/review)
enables a Data Exchange Admin to accept or reject both inbound and outbound share requests.

The operation now returns a resourceMap array that includes resource type-specific information:

  • If the resource type is EXPOSURE, each object returns the exposureId, resourceName, and securableId.
  • If the resource type is ANALYSIS, each object may return a mapping between an exposureId and an array of analysisIds or a mapping between a securableId an array of analysisIds.
{
  "reviewType": "INBOUND_ACCEPT",
  "settings": {
    "comment": "accepting",
    "serverId": 5308,
    "securableId": 771011,
    "resources": [
      {
        "resourceType": "EXPOSURE",
        "resourceMap": [
          {
            "exposureId": 21321312,
            "resourceName": "banana",
            "securableId": 345
          },
          {
            "exposureId": 21321313,
            "resourceName": "co6okie34",
            "securableId": 234
          },
          {
            "exposureId": 21321314,
            "resourceName": "blueberry",
            "securableId": 123
          }
        ]
      },
      {
        "resourceType": "ANALYSIS",
        "resourceMap": [
          {
            "exposureId": 13694811,
            "analysisIds": [16931626, 16932326]
          },
          {
            "analysisIds": [16931626, 16932326],
            "securableId": 771034
          },
          {
            "analysisIds": [23121, 1691231232326],
            "exposureId": 1234
          }
        ]
      }
    ]
  }
}

Export API

EDM and RDM Export

The Export API now supports uploading Version 25 EDM and RDM databases.

Get Import Jobs

The Get Import Job operation (GET /platform/import/v1/job/{jobId}) returns information about the specified import job.

This operation now returns detailed information about EXPOSURE_BATCH_EDIT jobs in the output.log object.

{
  "jobId": "35820214",
  "userName": "[email protected]",
  "status": "FINISHED",
  "submittedAt": "2025-06-26T14:02:53.687Z",
  "startedAt": "2025-06-26T14:02:55Z",
  "endedAt": "2025-06-26T14:03:03.197Z",
  "name": "EXPOSURE_BATCH_EDIT",
  "type": "EXPOSURE_BATCH_EDIT",
  "progress": 100,
  "entitlement": "RI-RISKMODELER",
  "resourceGroupId": "ef8dacb9-8e25-41b8-9520-5b771970eb6a",
  "priority": "medium",
  "details": {
    "resources": [
      {
        "uri": ""
      }
    ],
    "summary": ""
  },
  "tasks": [
    {
      "guid": "07481b20-c0e4-4341-8374-068a7503a7a5",
      "taskId": "1",
      "jobId": "35820214",
      "status": "Succeeded",
      "submittedAt": "2025-06-26T14:02:55.280Z",
      "createdAt": "2025-06-26T14:02:53.681Z",
      "name": "EXPOSURE_BATCH_EDIT",
      "output": {
        "summary": "",
        "errors": [],
        "log": {
          "Exposures": "{\"treaties\":[{\"label\":\"treatyLabel01\",\"treatyId\":1,\"treatyNumber\":\"TreayJun9075\"}],\"referDownloadLink\":true}",
          "Portfolios": "Inserted: 1, Updated: 0, Deleted: 0",
          "Accounts": "Inserted: 1, Updated: 0, Deleted: 0",
          "Locations": "Inserted: 1, Updated: 0, Deleted: 0",
          "Policies": "Inserted: 1, Updated: 0, Deleted: 0",
          "Step Policies": "Inserted: 1, Updated: 0, Deleted: 0",
          "Treaties": "Inserted: 1, Updated: 0, Deleted: 0",
          "Exposure Id": "13743661",
          "InputType": "Uploaded File",
          "downloadUrl": "https://d16fkjzdg1jvhz.cloudfront.net/2001716%2Fimport%2FEXPOSURE_BATCH_EDIT%2Foutputs%2F40eef744-5296-11f0-995a-b1486b0f8402.json?t=p3-rmteam-npe-apr21&c=d16fkjzdg1jvhz&d=rms-npe&e=2025-07-03T14:03:03.174Z",
          "platformDownloadUrl": "https://d16fkjzdg1jvhz.cloudfront.net/2001716%2Fimport%2FEXPOSURE_BATCH_EDIT%2Foutputs%2Fplatform-40eef744-5296-11f0-995a-b1486b0f8402.json?t=p3-rmteam-npe-apr21&c=d16fkjzdg1jvhz&d=rms-npe&e=2025-07-03T14:03:03.037Z"
        }
      },
      "percentComplete": 100
    }
  ]
}

EDM and RDM Import

The Import API now supports uploading Version 25 EDM and RDM databases.

Legacy API

Create Batch Template

The Create Batch Template operation (`POST /platform/referencedata/v1/batchtemplates) creates a batch template.

A batch template is a collection of analysis settings that are used to generate report views in UnderwriteIQ. Batch templates may specify model profile settings, event rate sets, output profile versions, analysis settings including DLM configurations and analysis currency, and report settings.

Batch templates created using this API operation can be used as analysis templates in the UnderwriteIQ application. To learn more, see Workflow Builder in Help Center.

The request specifies the name of the batch template, its entitlement, and the content of the template in the settings object.

{
  "name": "Test_Batch_Template_API_1",
  "settings": {
    "analysisSettings": {
      "currency": {
        "asOfDate": "2025-05-28T00:00:00.000Z",
        "currency": "USD",
        "currencyScheme": "RMS",
        "currencyVersion": "RL25"
      },
      "dlmSettings": {
        "franchiseDeductible": false,
        "minLossThreshold": "1.00",
        "numMaxLossEvent": "1",
        "treatConstructionOccupancyAsUnknown": true
      }
    },
    "asDefault": false,
    "createdBy": "[email protected]",
    "createdDate": "2025-06-25",
    "geocodeHazard": [],
    "groupings": [],
    "id": "dc986130-b988-4264-976c-f680cf7c8464",
    "jobName": "Default_UIQAutomation_WFB_Job",
    "marginalImpacts": [],
    "modifiedDate": "2025-06-25",
    "pricing": {},
    "profiles": {
      "modelAnalyses": [
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 6888,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 2146,
          "pricing": false
        },
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 6888,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 2157,
          "pricing": false
        }
      ],
      "outputProfile": {
        "outputProfileId": 363,
        "perspective": "C0,CG,CL,EL,FA,G2,GR,GS,GU,I0,IG,LG,M0,MG,NP,OI,OL,QS,RC,RG,RL,RN,RP,SS,TV,UC,WX,UNCERTAINTY,HAZARD,DAMAGE"
      }
    },
    "reportName": "Default_UIQAutomation_WFB_Report",
    "reportSettings": {
      "exposureSummary": false,
      "locationDetails": false
    },
    "templateName": "Default_UIQAutomation_WFB",
    "isPreConfiguredWB": true
  },
  "entitlement": "RI-UNDERWRITEIQ"
}

To perform this operation the client must belong to a group that has been assigned the Create Analysis Template action.

đŸ“·

Entitlements

This operation requires the RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Search Batch Templates

The Search Batch Templates operation (`POST /platform/referencedata/v1/batchtemplates) returns a list of batch templates.

A batch template is a collection of analysis settings that are used to generate report views in UnderwriteIQ. Batch templates may specify model profile settings, event rate sets, output profile versions, analysis settings including DLM configurations and analysis currency, and report settings. Batch templates can be used as analysis templates in the UnderwriteIQ application. To learn more, see Workflow Builder in Help Center.

For each batch template the response returns metadata including its id and entitlement.

{
  "count": 3,
  "items": [
    {
      "id": 7,
      "name": "10 MP",
      "createdBy": "[email protected]",
      "createdAt": "2025-07-03T20:54:12.900+00:00",
      "modifiedAt": "2025-07-03T20:54:12.900+00:00",
      "entitlement": "RI-RISKMODELER",
      "isDefault": false
    },
    {
      "id": 61,
      "name": "20250117",
      "createdBy": "[email protected]",
      "createdAt": "2025-07-03T20:54:22.812+00:00",
      "modifiedAt": "2025-07-03T20:54:22.812+00:00",
      "entitlement": "RI-RISKMODELER",
      "isDefault": false
    },
    {
      "id": 60,
      "name": "20250117jjj",
      "createdBy": "[email protected]",
      "createdAt": "2025-07-03T20:54:22.642+00:00",
      "modifiedAt": "2025-07-03T20:54:22.642+00:00",
      "entitlement": "RI-RISKMODELER",
      "isDefault": false
    }
  ]
}

đŸ“·

Entitlements

This operation requires the RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Get Batch Template

The Get Batch Template operation (GET /platform/referencedata/v1/batchtemplates/id) returns the specified batch template.

A batch template is a collection of analysis settings that are used to generate report views in UnderwriteIQ. Batch templates may specify model profile settings, event rate sets, output profile versions, analysis settings including DLM configurations and analysis currency, and report settings. Batch templates can be used as analysis templates in the UnderwriteIQ application. To learn more, see Workflow Builder in Help Center.

This operation returns detailed infomation about the content of the response template.

{
  "id": 7,
  "name": "10 MP",
  "createdBy": "[email protected]",
  "createdAt": "2025-07-03T20:54:12.900+00:00",
  "modifiedAt": "2025-07-03T20:54:12.900+00:00",
  "settings": {
    "analysisSettings": {
      "currency": {
        "asOfDate": "2025-05-28T00:00:00.000Z",
        "currency": "USD",
        "currencyScheme": "RMS",
        "currencyVersion": "RL25"
      },
      "dlmSettings": {
        "franchiseDeductible": false,
        "minLossThreshold": "1.00",
        "numMaxLossEvent": "1",
        "treatConstructionOccupancyAsUnknown": true
      }
    },
    "asDefault": false,
    "createdBy": "[email protected]",
    "createdDate": "2025-06-01",
    "geocodeHazard": [
      {
        "engineType": "RL",
        "layerOptions": {
          "aggregateTriggerEnabled": "true",
          "geoLicenseType": "0",
          "skipPrevGeocoded": false
        },
        "name": "geocode",
        "type": "geocode",
        "version": "25.0"
      },
      {
        "engineType": "RL",
        "layerOptions": {
          "overrideUserDef": false,
          "skipPrevHazard": false
        },
        "name": "earthquake",
        "type": "hazard",
        "version": "25.0"
      },
      {
        "engineType": "RL",
        "layerOptions": {
          "overrideUserDef": false,
          "skipPrevHazard": false
        },
        "name": "windstorm",
        "type": "hazard",
        "version": "25.0"
      }
    ],
    "groupings": [],
    "id": "349f8cc7-835c-4d35-9dcf-7a5386df4897",
    "jobName": "10 MP",
    "marginalImpacts": [],
    "modifiedDate": "2025-06-01",
    "profiles": {
      "modelAnalyses": [
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 37,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 1
        },
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 173,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 7
        },
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 184,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 8
        },
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 62,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 9
        },
        {
          "currency": {
            "asOfDate": "2025-05-28T00:00:00.000Z",
            "currency": "USD",
            "currencyScheme": "RMS",
            "currencyVersion": "RL25"
          },
          "eventRateSet": 64,
          "id": 1,
          "isDefaultCurrency": true,
          "modelProfile": 10
        }
      ],
      "outputProfile": {
        "outputProfileId": 701,
        "perspective": "GU,G2,GS,CL,UC,OI,OL,GR,FA,QS,SS,WX,RL,RP,RC,RG,RN,TV,NP,CG,C0,LG,MG,M0,IG,I0,EL,HAZARD,DAMAGE,UNCERTAINTY"
      }
    },
    "reportName": "10 MP",
    "reportSettings": {
      "exposureSummary": false,
      "locationDetails": false
    },
    "templateName": "10 MP",
    "isPreConfiguredWB": true
  },
  "entitlement": "RI-RISKMODELER",
  "isDefault": false

đŸ“·

Entitlements

This operation requires the RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Update Batch Template

The Update Batch Template operation (PATCH /platform/referencedata/v1/batchtemplates/id) updates the specified batch template.

A batch template is a collection of analysis settings that are used to generate report views in UnderwriteIQ. Batch templates may specify model profile settings, event rate sets, output profile versions, analysis settings including DLM configurations and analysis currency, and report settings. Batch templates can be used as analysis templates in the UnderwriteIQ application. To learn more, see Workflow Builder in Help Center.

đŸ“·

Entitlements

This operation requires the RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Delete Batch Template

The Delete Batch Template operation (`POST /platform/referencedata/v1/batchtemplates/id) deletes the specified batch template.

A batch template is a collection of analysis settings that are used to generate report views in UnderwriteIQ. Batch templates may specify model profile settings, event rate sets, output profile versions, analysis settings including DLM configurations and analysis currency, and report settings. Batch templates can be used as analysis templates in the UnderwriteIQ application. To learn more, see Workflow Builder in Help Center.

đŸ“·

Entitlements

This operation requires the RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Output Profiles

The Create Output Profile operation (POST /analysis-settings/outputprofiles) enables the client to create an output profile.

An output profile is a configuration that identifies the loss tables, EP metrics, and statistics output to an analysis result. This output profile specifies the granularity (resolution) of the results returned in the analysis and the financial perspectives used to calculate modeled losses.

This operation now supports improved support for the modeling locatons and policies covered by facultative cessions using HD models. The metricsRequests parameter now enables the client to specify Facultative as the resolution (geographic granularity) of computed statistics (STATS), EP curves (EP), and loss tables (LOSS_TABLES).

The metricRequests array specifies a list of objects that determine the metrics returned in an analysis. Each object maps a metric type (e.g. EP), a financial perspective (e.g. FA), and granularity (e.g. Facultative) to define metric request settings. Thegranularity value specifies the resolution of the metric data.

The granularity and perspective of each metric can be specified to support the modeling of facultative cessions using HD models.

{
  "excludeDefaultMetrics": true,
  "metricRequests": [
    {
      "metricType": "STATS",
      "includeIntermediateSums": false,
      "granularity": ["Facultative"],
      "perspective": "FA"
    },
    {
      "metricType": "EP",
      "includeIntermediateSums": false,
      "granularity": ["Facultative"],
      "perspective": "FA"
    },
    {
      "metricType": "LOSS_TABLES",
      "includeIntermediateSums": false,
      "granularity": ["Facultative"],
      "perspective": "FA"
    }
  ],
  "name": "My Fac Cession Output Profile"
}

The Facultative granularity is applicable only to analysis modeled using HD models. If the output profile is used with an DLM model, the granularity value is ignored.

Formerly, if the model profile specified FA (facultative) as the value of the perspective parameter, the analysis would return AAL (UNCERTAINTY), EP curves (EP), and PLT (LOSS_TABLES) by default when analyzing portfolios using HD models, which could cause the analysis to crash if the portfolio included hundreds of thousands of facultative cessions. This change provides cat modelers with greater control when modeling these porfolios.

Risk Data API

Analyses

Calculate Climate Change

The Calculate Climate Change operation (POST /platform/riskdata/v1/analyses/{id}/climate-change) calculates climate change analysis as a post-analysis action using the specified analysis result as a reference analysis.

MoodyÊŒs has updated the HD Climate Change Model for the North America Wildfire HD models to add support for version HDv2.0. North America Wildfire HD models now support SSP scenarios instead of the RCP scenarios used in prior climate change model releases.

This operation now accepts two new body parameters: type and sspScenario. The rcpScenario parameter, which was formerly required is now optional.


{
  "analysisName": "RL18_AllModel_ULFTest_HDEDM_rv1_7",
  "referenceRateSchemeId": 53,
  "climateConditionView": "Default",
  "is2CWarmingScenario": false,
  "timeHorizon": 2030,
  "sspScenario": "1-2.6",
  "type": "ssp"

ParameterTypeDescription
typeStringSets the climate change analysis type. One of ssp, rcp, ss
rcpScenarioStringSpecifies RCP scenario. One of 2.6, 4.5, 6.0, 8.5. Required if type is rcp.
sspScenarioStringSpecifies SSP scenario. One of 1-2.6, 2-4.5, 3-7.0, or 5-8.5. Required if type is ssp.

This operation returns an error if sspScenario parameter is passed in the request for any analysis other than NAWF2.0 HD.


{
    "code": "CLIMATE-CHANGE-020",
    "message": "Type ssp is not supported for the given model versions/regions.",
    "logId": "430e81d4baac567f"

Refresh Account Metadata

The Refresh Account Metadata operation (POST /platform/riskdata/v1/exposures/{id}/accounts/id/update-metrics) recalculates summary metrics for the specified account.

Summary account metrics are metadata quantify the scope of an account by providing a total count of sources. Summary account metrics include totalLocations, totalPolicies, totalEmployees, and totalInsuredValue.

đŸ“·

Entitlements

This operation requires the RI-EXPOSUREIQ,RI-RISKMODELER, RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Refresh Aggregate Portfolio Metadata

The new Refresh Aggregate Portfolio Metadata operation (POST /platform/riskdata/v1/exposures/{id}/aggregateportfolios/id/update-metrics) recalculates summary metrics for the specified aggregate portfolio.

Summary aggregate portfolio metrics are metadata quantify the scope of an aggregate portfolio by providing a total count of resources including the totalAggregateExposures.

Refresh Portfolio Metadata

The Refresh Portfolio Metadata operation (POST /platform/riskdata/v1/exposures/{id}/portfolio/id/update-metrics) recalculates summary metrics for the specified portfolio.

Summary portfolio metrics are metadata quantify the scope of a portfolio by providing a total count of sources. Summary portfolio metrics include totalAccounts, totalLocations, and totalPolicies.

đŸ“·

Entitlements

This operation requires the RI-EXPOSUREIQ,RI-RISKMODELER, RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Refresh EDM Metadata

The Refresh EDM Metdata operation (POST /platform/riskdata/v1/exposures/{id}/update-metrics) recalculates summary metrics for the specified EDM.

Summary EDM metrics are metadata that quantify the scope of an EDM by providing a total count of sources. Summary portfolio metrics include totalAccounts, totalLocations, totalPolicies, totalPortfolios.

đŸ“·

Entitlements

This operation requires the RI-EXPOSUREIQ,RI-RISKMODELER, RI-UNDERWRITEIQ entitlement. To learn more, see Entitlements.

Get Rollup EP Metrics

The Get Rollup EP Metrics operation (GET /platform/riskdata/v1/analyses/{id}/rollup-ep) returns EP metrics for the specified analysis.

Exceedance probability (EP) analysis takes the full range of possible events and losses into consideration during analysis. These losses are expressed as occurrence exceedance probability curves (OEP curves) and aggregate exceedance probability curves (AEP curves).

The response returns metadata about the analysis and EP metrics.

[
  {
    "positionName": "string",
    "positionType": "Contract",
    "positionUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "nodeSubType": "PORTFOLIO",
    "scenarioName": "string",
    "scenarioUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "treaty": {
      "treatyUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "treatyName": "string",
      "programName": "string",
      "share": 0,
      "programSetName": "string",
      "programSetCedant": "string",
      "cedenceType": "InwardProgram",
      "currencyCode": "string",
      "templateCode": "string",
      "occurrenceLimitAmount": 0,
      "aggregateLimitAmount": 0
    },

    "epMetrics": [
      {
        "returnPeriod": 0,
        "epType": "oep",
        "value": 0,
        "percent": 0,
        "difference": 0
      }
    ]
  }
]

đŸ“·

Entitlements

This operation requires the RI-TREATYIQ entitlement. To learn more, see Entitlements.

Get Rollup Key Loss Statistics

The Get Rollup Key Losses operation (GET /platform/riskdata/v1/analyses/{id}/rollup-key-losses) returns non-EP statstics for the specified non-EP rollup analysis.

Key loss statistics include coefficient of variation (cv), mean loss (meanloss), standard deviation (stdDev), probablity of attachment (probabilityOfAttachment), and probability of exhaustion (probabilityOfExhaustion).

[
  {
    "positionName": "string",
    "positionType": "Contract",
    "positionUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "nodeSubtype": "PORTFOLIO",
    "scenarioName": "string",
    "scenarioUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "treaty": {
      "treatyUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "treatyName": "string",
      "treatyProgramName": "string",
      "share": 0,
      "treatyProgramSetName": "string",
      "treatyProgramSetCedant": "string",
      "cedenceType": "InwardProgram",
      "currencyCode": "string",
      "templateCode": "string",
      "occurrenceLimitAmount": 0,
      "aggregateLimitAmount": 0
    },
    "meanLoss": 0,
    "stdDev": 0,
    "cv": 0,
    "probabilityOfAttachment": 0,
    "probabilityOfExhaustion": 0
  }
]

đŸ“·

Entitlements

This operation requires the RI-TREATYIQ entitlement. To learn more, see Entitlements.

Risk Data Jobs

The Search Risk Data Job and Get Risk Data Job operations return information about Risk Data jobs.

These operations now return additional information about CLIMATE CHANGE jobs: type, sspScenario.

ParameterTypeDescription
typeStringIndicates the climate change analysis type. One of ssp rcp
sspScenarioStringIndicates the SSP scenario. One of 1-2.6, 2-4.5, 3-7.0, or 5-8.5.

Get Risk Data Jobs

The Get Risk Data Job operation (GET /platform/riskdata/v1/jobs/{jobId}) returns information about Risk Data jobs.

This operation now returns "downloadLink in the batchOutput even when the exposures object is not empty. The JSON pathing needs either the JSON the exposures object or downloadLink to create the dependency context. The downloadLink was cleared out if exposures object was not empty.

If the workflow type of the job is EXPOSURE_BATCH_EDIT, the response now returns both the downloadLink property in the jobs.output object:

{
    "id": 35891254,
    "userName": "[email protected]",
    "status": "FINISHED",
    "submitTime": "2025-06-30T12:04:06.243Z",
    "startTime": "2025-06-30T12:04:24Z",
    "endTime": "2025-06-30T12:04:32Z",
    "name": "EXPOSURE_BATCH_EDIT",
    "type": "EXPOSURE_BATCH_EDIT",
    "progress": 100,
    "priority": "medium",
    "entitlement": "RI-RISKMODELER",
    "resourceGroupId": "ef8dacb9-8e25-41b8-9520-5b771970eb6a",
    "jobs": [
        {
            "id": "798a3a43-8c34-40a2-bf0d-3191ff68a476",
            "taskId": 1,
            "workflowId": 35891254,
            "status": "Succeeded",
            "submitTime": "2025-06-30T12:04:08.068Z",
            "createdAt": "2025-06-30T12:04:06.235Z",
            "name": "EXPOSURE_BATCH_EDIT",
            "input": {
                "name": "EXPOSURE_BATCH_EDIT"
            },
            "output": {
                "Treaties": "Inserted: 0, Updated: 0, Deleted: 0",
                "Exposures": "{\"referDownloadLink\":true}", -- exposures not empty
                "Policies": "Inserted: 44, Updated: 0, Deleted: 0",
                "Step Policies": "Inserted: 0, Updated: 0, Deleted: 0",
                "InputType": "Plain JSON",
                "databaseName": "irpUpdateMetricsTestEdm_QGC",
                "downloadLink": "https://rms-tenants-npe-eu-west-1.s3.eu-west-1.amazonaws.com/2001716/import/EXPOSURE_BATCH_EDIT/outputs/798a3a43-8c34-40a2-bf0d-3191ff68a476.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250630T120431Z&X-Amz-SignedHeaders=host&X-Amz-Credential=AKIA3CNSARQO6ABWUXXI%2F20250630%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Expires=604800&X-Amz-Signature=bda0b705fb1889595d567cdee405240e4435fa804912573a0e727c001f458999",
                "platformDownloadLink": "https://rms-tenants-npe-eu-west-1.s3.eu-west-1.amazonaws.com/2001716/import/EXPOSURE_BATCH_EDIT/outputs/platform-798a3a43-8c34-40a2-bf0d-3191ff68a476.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250630T120431Z&X-Amz-SignedHeaders=host&X-Amz-Credential=AKIA3CNSARQO6ABWUXXI%2F20250630%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Expires=604800&X-Amz-Signature=218ad70746a40b929e778ca1d5ce856b95424babef28ad2a363e2bb53e70996d",
                "Locations": "Inserted: 44, Updated: 0, Deleted: 0",
                "Exposure Id": "11259203",
                "Accounts": "Inserted: 44, Updated: 0, Deleted: 0",
                "Portfolios": "Inserted: 8, Updated: 0, Deleted: 0"
            },
            "percentComplete": 100,
            "continueOnFailure": false
        }
    ],
    "summary": {
        "databaseName": "irpUpdateMetricsTestEdm_QGC",
        "InputType": "Plain JSON",
        "Portfolios": "Inserted: 8, Updated: 0, Deleted: 0",
        "Accounts": "Inserted: 44, Updated: 0, Deleted: 0",
        "Locations": "Inserted: 44, Updated: 0, Deleted: 0",
        "Policies": "Inserted: 44, Updated: 0, Deleted: 0",
        "Step Policies": "Inserted: 0, Updated: 0, Deleted: 0",
        "Treaties": "Inserted: 0, Updated: 0, Deleted: 0"
    },
    "output": {
        "downloadLink": "https://rms-tenants-npe-eu-west-1.s3.eu-west-1.amazonaws.com/2001716/import/EXPOSURE_BATCH_EDIT/outputs/798a3a43-8c34-40a2-bf0d-3191ff68a476.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250630T120431Z&X-Amz-SignedHeaders=host&X-Amz-Credential=AKIA3CNSARQO6ABWUXXI%2F20250630%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Expires=604800&X-Amz-Signature=bda0b705fb1889595d567cdee405240e4435fa804912573a0e727c001f458999",
        "stepPolicies": [],
        "treaties": [],
        "policies": [],
        "portfolios": [],
        "locations": [],
        "accounts": [],
        "referDownloadLink": true
    },
    "messages": []
}

Variation API

The Create Variation Job operation now accepts an optional riskViews parameter, which determines whether risk-by-peril data is provided for the portfolio variations created in the request.

An exposure variation is a snapshot of an existing exposure (e.g. a portfolio variation of portfolio). Exposure variations enable tenants to ensure that reports and data exports accurately reflect the actual state of an exposure. Distinct exposure variations may be distinguished by distinct treaties or currency schemes.

This new riskViews parameter accepts a Boolean value. If true, the resulting portolio variation can return risk-by-peril views, which is akin to a flattened denormalized risk view that returns total insurable values (TIVs) values pre-computed by peril for quick analytics and reporting.

đŸ“·

Entitlements

To run this operation the client must belong to a tenant that has been assigned the RI-EXPOSUREIQ entitlement.