2025.09.b

🥥

Highlights

The 2025.09.b release introduces updates to the Risk Data API.

  • The Risk Data API now manages Exposure Bulk Edit responses differently depending on the size of the response object. Response data can be downloaded from separate link.
  • The Risk Data API now returns new analysis properties that provide information about settings used in the analysis.
  • The Risk Data API now supports enhancements in support of TreatyIQ workflows including the retrieval of rollup pricing statistics and updates to the bulk creation of risk sources.

Learn More

Risk Data API

Get Analysis Result

The Search Analysis Results operation (/platform/riskdata/v1/analyses) and Get Analysis Result operation (/platform/riskdata/v1/analyses/{analysisId}) return information about analysis results.

Both of these operations now return several new properties in the additionalProperties array: multiFamilyFactor, multiFamilyRate, otherFactor, otherRate, scaleBiValues, scaleBuildingValues, scaleContentValues, scaleFactor, singleFamilyFactor, and singleFamilyRate.

PropertyTypeDescription
multiFamilyFactornumberUser-defined factor for low-rise, multi-family dwellings and commercial properties that modifies ground up surge assumptions.
multiFamilyRatenumberCustom National Flood Insurance Program (NFIP) take-up rate for low-rise multi-family dwellings and commercial properties that modifies ground up surge assumptions.
otherFactornumberUser-defined factor for other properties that modifies ground up surge assumptions.
otherRatenumberCustom National Flood Insurance Program (NFIP) take-up rate for other properties that modifies ground up surge assumptions.
scaleBiValuesnumberScale value applied to business interruption value when calculating damage. Values between 0–100. The default is 1.
scaleBuildingValuesnumberScale value applied to building value when calculating damage. Values between 0–100. The default is 1.
scaleContentValuesnumberScale value applied to content value when calculating damage. Values between 0–100. The default is 1.
scaleFactornumberScale factor used in analysis to adjust for increased replacement costs to buildings.
singleFamilyFactornumberCustom National Flood Insurance Program (NFIP) take-up rate for single family dwellings to modify ground up surge assumptions.
singleFamilyRatenumberUser-defined factor for single family dwellings to modify ground up surge assumptions

These properties are returned in the analysisInfo object of the additionalProperties array in the response. The returned data represents data stored in the
RMS_RDM.rdm_analysis table. For each property, the response returns the id, name, and value:


{
  "analysisId": 29269912,
  "analysisName": "rl18_testedm_024a_databridge-1: PORTFOLIO: Port_All_Acc",
  "createDate": "2025-08-28T18:16:29",
  ...
  "modelProfile": {},
  "outputProfile": {},
  "engineType": "DLM",
  "eventRateSchemeNames": [],
  "currency": {},
  ...
  "additionalProperties": [
    {
      "key": "analysisInfo",
      "properties": [
        {
          "id": 0,
          "name": "scalefactor",
          "value": "1.0"
        },
        {
          "id": 0,
          "name": "singlefamilyrate",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "multifamilyrate",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "otherrate",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "singlefamilyfactor",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "multifamilyfactor",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "otherfactor",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "scalebldgvalues",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "scalecontentvalues",
          "value": "0.0"
        },
        {
          "id": 0,
          "name": "scalebivalues",
          "value": "0.0"
        }
      ]
    }
  ],
  ...
  "tagIds": []
}

The Search Analysis Results operation (/platform/riskdata/v1/analyses) returns a list of filtered analysis results.

This operation now supports filtering and sorting by description and currencyName properties.

PropertyTypeComparisonListLogical
descriptionString=, !=, LIKE, NOT LIKEIN, NOT INAND, OR
currencyNameString=, !=, LIKE, NOT LIKEIN, NOT INAND, OR

Get Rollup Pricing Statistics

The Search Rollup Pricing Statistics operation (GET /platform/riskdata/v1/analyses/{analysisId}/rollup-pricing-stats) returns pricing statistics for the specified rollup analysis.

[
  {
    "positionName": "string",
    "positionUuid": "string",
    "positionType": "string",
    "pricingType": "string",
    "price": 0,
    "capital": 0,
    "rateOnLine": 0,
    "lossOnLineMean": 0,
    "lossOnLineStdDev": 0,
    "probabilityOfAttachment": 0,
    "probabilityOfExhaustion": 0,
    "probabilityOfBreakEven": 0,
    "combinedRatioMean": 0,
    "combinedRatioStdDev": 0,
    "returnOnCapitalMean": 0,
    "returnOnCapitalStdDev": 0,
    "riskMeasures": [
      {
        "identifier": "string",
        "metricType": "Mean",
        "value": 0
      }
    ],
    customMeasures": [
      {
        "identifier": "string",
        "name": "string",
        "formula": "string"
        "value": 0
      }
    ]
  }
]

To perform this operation, the tenant must be assigned the RI-TREATYIQ entitlement.

Exposure Bulk Edit

The Exposure Bulk Edit operation (POST /platform/riskdata/v1/exposures/{exposureId}/bulk-edit) creates, updates, or deletes multiple exposures (portfolios, accounts, locations, policies, or treaties) in a single request.

The request body defines an object that consists of five arrays: a portfolios array, accounts array, locations array, policies, and treaties array. Where parent-child relationships exist between exposures (e.g. between a portfolio and its accounts, or accounts and locations), child exposures may be nested within the parent exposure.

On success, this operation returns a 202 Accepted response and adds a BULK_EDIT job to the workflow engine queue. The Location response header specifies the job ID as part of a URL that you can use to track the status of the job.

Once the BULK_EDIT job is complete and its status is set to FINISHED, the Get Risk Data Job response returns information about the exposures updated in the EDM.

The response objects differs depending on the size of the response:

  • If fewer than 10,000 characters are returned, all exposure data is returned, e.g. portfolios, accounts, locations, policies, and treaties.
  • If more than 10,000 characters are returned, the ID numbers of the account and portfolio exposures are returned. The remaining exposure data can be downloaded from the specified downloadLink.
  • If more than 100,000 characters of account and portfolio data are returned, no exposures are returned in the response. All exposure data can be downloaded from the specified downloadLink.

In the following example, the response object consists (more than 10,000 character, but fewer than 100,000 characters)

{
  "userName": "[email protected]",
  "status": "FINISHED",
  "name": "ExBatchEdit",
  "type": "EXPOSURE_BATCH_EDIT",
  "progress": 100,
  "priority": "medium",
  "entitlement": "RI-RISKMODELER",
  "resourceGroupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "jobs": [
    {
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "taskId": 1,
      "status": "Succeeded",
      "name": "EXPOSURE_BATCH_EDIT",
      "percentComplete": 100,
      "continueOnFailure": false
    }
  ],
  "summary": {
    "Treaties": "Inserted: 0, Updated: 0, Deleted: 0",
    "Policies": "Inserted: 100, Updated: 0, Deleted: 0",
    "databaseName": "xxxxxxxxxxxxxxxxxxxxxxx",
    "InputType": "Plain JSON",
    "stepPolicies": "Inserted: 0, Updated: 0, Deleted: 0",
    "Locations": "Inserted: 1000, Updated: 0, Deleted: 0",
    "Portfolios": "Inserted: 10, Updated: 0, Deleted: 0",
    "Accounts": "Inserted: 100, Updated: 0, Deleted: 0"
  },
  "output": {
    "downloadLink": "https://rms-tenants-xxx-xxx.amazonaws.com/xxx/import/EXPOSURE_BATCH_EDIT/outputs/xxx",
    "stepPolicies": [],
    "treaties": [],
    "portfolios": [
      {
        "number": "CreatedPortfolio",
        "name": "CreatedPortfolio",
        "label": "port1",
        "id": 502,
        "accounts": [
          {
            "number": "CreatedAccount",
            "id": 3363
          },
          {...},
          {...}
        ]
      },
      {...},
      {...}
    ],
    "policies": [],
    "locations": [],
    "accounts": [],
    "referDownloadLink": true
  },
  "messages": []
}

Bulk Create Risk Source

The Bulk Create Risk Source operation operation (GET /platform/riskdata/v1/risksources/bulk-create) creates multiple risk sources for the specified program or business hierarchy.

This operation now supports the optional tile body parameter. If true, the PLT data returned in response is "tiled" (extrapolated) if date range or period ranges are insufficient to match the simulation settings of the analysis. This option enables TreatyIQ clients to model the risk to treaties, if the dates of the underlying loss tables do not align with the treaty dates, without the need to apply workarounds.

A risk source is a representation of risk to a cedant that underlies a program (reinsurance program). This API supports the creation of two types of risk sources: PORTFOLIO or RISKANALYSIS. Every risk source created in a bulk operation is attached to the specified parent (BUSINESSHIERARCHY or PROGRAM).

To perform this operation, the tenant must be assigned the RI-TREATYIQ entitlement.

Create Risk Data Report

The Create Risk Data Report operation (POST /platform/riskdata/v1/reports) creates downloadable reports, e.g. exposure summary reports.

Five types of reports are supported: exposure summary report (EXPOSURE_SUMMARY), analysis summary report (ANALYSIS_SUMMARY), California DOI report (EXPOSURE_DOI_REPORT), Portfolio accumulation report (PORTFOLIO_ACCUMULATION_DETAILS), Business hierarchy report (BUSINESS_HIERARCHY_ACCUMULATION_DETAILS)

The Portfolio accumulation report (PORTFOLIO_ACCUMULATION_DETAILS) report type is now accessible to tenants with RI-RISKMODELER entitlement.
,