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.
Property | Type | Comparison | List |
---|---|---|---|
archivedBy | String | = , != , LIKE , NOT LIKE | IN ,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 theedmVersion in each
resourceProperties` object.ANALYSIS
resource type objects now return theanalysisEngineType
andanalysisFramework
properties (e.g.ELT
,PLT
) in eachresourceProperties
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 theexposureId
,resourceName
, andsecurableId
. - If the resource type is
ANALYSIS
, each object may return a mapping between anexposureId
and an array ofanalysisIds
or a mapping between asecurableId
an array ofanalysisIds
.
{
"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"
Parameter | Type | Description |
---|---|---|
type | String | Sets the climate change analysis type. One of ssp , rcp , ss |
rcpScenario | String | Specifies RCP scenario. One of 2.6 , 4.5 , 6.0 , 8.5 . Required if type is rcp . |
sspScenario | String | Specifies 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
.
Parameter | Type | Description |
---|---|---|
type | String | Indicates the climate change analysis type. One of ssp rcp |
sspScenario | String | Indicates 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.