🥥
Highlights
The January release introduces updates to the Admin Data, Risk Data, and Risk View APIs.

The Search EDMs operation now returns the exposureSetName property.

The Risk Data API now enables clients with the RI-UNDERWRITEIQ entitlement to filter Report View data by analysis. Report View lists can now be filtered by either appAnalysisId or analysisId.

The Get Report View operation now returns marginal impact analysis metrics (if available) as part of a report view.

Learn More

Admin Data API

The Get Admin Job operation now returns a log object that returns summary details about the archive created during the specified admin job.

An archive is a copy of a database that has been deleted from a server instance. The Intelligent Risk Platform implements soft deletes by default. A deleted database is inaccessible, but the archive of that database remains accessible for up to 90 days.

Admin Data jobs include RESTORE_ARCHIVE and DELETE_ARCHIVE jobs. Whenever a principal restores or deletes an archive, a new job is initiated on the Intelligent Risk Platform. This operation provides destailed information about that job.

This log object is returned in the details object of the response.

Property	Type	Description
`archiveId`	`string`	ID of the archive, a copy of a database that has been deleted from a database server instance.
`databaseName`	`string`	Name of deleted database.
`exposureSetId`	`string`	ID of exposure set.
`owner`	`string`	Email of database owner, the principal that deleted the database.
`serverId`	`string`	ID of database server that hosted the deleted database.
`serverName`	`string`	Name of database server that hosted the deleted database.
`serverType`	`string`	One of `DATABRIDGE`, `PLATFORM`

Risk Data API

Exposures

The Search EDMs operation (/platform/riskdata/v1/exposures) now returns exposureSetName, which enable clients to easily identify corresponding exposure sets.

An exposure set is a collection of exposure data and related analysis result data that is managed by means of an access control list (ACL). The exposure set ACL specifies the groups that may access and perform operations on exposure set data.

Property	Type	Description
`exposureSetName`	String	Name of the exposure set.

This operation can be performed by clients with the RI-RISKMODELER and RI-UNDERWRITEIQ entitlements.

[
    {
        "exposureName": "XXX",
        "exposureId": 1741006,
        "uri": "/platform/riskdata/v1/exposures/1741006",
        "status": "READY",
        "databaseName": "_Edm_DB_Original",
        "metrics": {
            "dbsize_actual": "514048",
            "accountCount": 16,
            "size": "502 MB",
            "dataVersion": "22.0.0",
            "cedantCount": 2,
            "locationCount": 10203,
            "portfolioCount": 1,
            "treatyCount": 0,
            "edmVersion": "24",
            "aggregatedPortfolioCount": 0,
            "lastModified": "2024-12-31 08:23:40.00"
        },
        "ownerName": "XXXX.XX.COM",
        "exposureSetId": 1741005,
        "exposureSetName": "_Edm_DB_Original", <-- NEW
        "serverType": "DATA_BRIDGE",
        "serverName": "databridge-2",
        "serverId": 12,
        "tagIds": [
            1390
        ]
    }
]

Report View

The Get Report View now supports filtering response data using the analysisId and appAnalysisId query parameters. If specified, the returned report includes only data in the specified analysis.

A report view is a collection of reports that return exposure-specific metrics and statistics. The report view is generated automatically whenever an Underwrite IQ client creates exposures in batch using the Exposure Bulk Edit operation.

curl --request GET \
     --url https://{{xxxxx}}/platform/riskdata/v1/reportviews/5748?appAnalysisId=123 \
     --header 'accept: application/json'

To perform this operation the client must be assigned the RI-UNDERWRITEIQ entitlement.

The response now includes the appAnalysisId property:

{
    "reportViewId": 5748,
    "reportViewName": "XXXXX",
    "exposureName": "RMS_EDM_UIQ_UIAutomation",
    "createdAt": "2025-01-17T03:30:45.456Z",
    "exposureId": 120,
    "exposureResourceId": 6556,
    "exposureResourceType": "ACCOUNT",
    "createdBy": "[email protected]",
    "notes": "",
    "details": [
        {
            "metricType": "ELT",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/elt?perspectiveCode=OL&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXXXXXXXXXXXXXXXXX"
            }
        },
        {
            "metricType": "ELT",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/elt?perspectiveCode=RL&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXX"
            }
        }
        {
            "metricType": "STATS",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/stats?perspectiveCode=OL&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXX"
            }
        },
        {
            "metricType": "STATS",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/stats?perspectiveCode=RL&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXX"
            }
        },
        {
            "metricType": "EP",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/ep?perspectiveCode=GR&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXX"
            }
        },
        {
            "metricType": "EP",
            "analysisId": 5334752,
            "appAnalysisId": 148039,
            "metricUrl": "https://XXXXX/platform/riskdata/v1/analyses/5334752/ep?perspectiveCode=GU&exposureResourceId=6556&exposureResourceType=ACCOUNT",
            "additionalInfo": {
                "peril": "EQ",
                "region": "NA",
                "analysisName": "XXXXX"
            }
        }
    ]
}

The Get Report View now returns marginal impact analysis metrics in a report view. A report view is a collection of reports that return exposure-specific metrics and statistics in support of underwriting workflows.

A marginal impact analysis compares a portfolio-level analysis result with a new analysis that incorporates one or more account-level analysis results. The Intelligent Risk Platform calculates the difference between the reference analysis "group" and the new marginal impact "group".

The report view may now return the following HD analysis metric types:

GROUP_EP
GROUP_STATS
GROUP_POLICY_EP
GROUP_POLICY_STATS
GROUP_ELT
GROUP_PLT
GROUP_MARGINAL_EP
GROUP_MARGINAL_STATS

Marginal impact analysis metrics are only included a report view if the EXPOSURE BULK EDIT job (user-defined workflow) that generated the report view includes marginal impact analysis and HD analysis grouping. The report view is generated automatically whenever an Underwrite IQ client creates exposures in batch using the Exposure Bulk Edit operation.

Search Report View

The new Search Report View Metadata operation returns the metadata of all the analyses in the report view.

This operation supports response filtering using appAnalysisId and analysisId as query filters.

curl --request GET \
     --url https://{{xxxxx}}/platform/riskdata/v1/reportviews/5748/analyses?appAnalysisId=123 \
     --header 'accept: application/json'

To perform this operation the client must be assigned the RI-UNDERWRITEIQ entitlement.

This operation supports response filtering based the value of a subset of properties. Depending on the property, you may use a combination of comparison operators, list operators, and logical operators.

Property	Type	Comparison	List
`analysisId`	Number	=, !=	IN
`appAnalysisId`	Number	=, !=	IN

Returns a list of that matches the specified query:

[
  {
    "analysisId": 5334779,
    "appAnalysisId": 148037,
    "analysisName": "RMS_EDM_UIQ_UIAutomation: ACCOUNT: EQ_WS_WC_POL",
    "analysisType": "DLM",
    "peril": "WS",
    "metricTypes": ["POLICY_EP", "EP", "POLICY_STATS", "ELT", "STATS"]
  },
  {
    "analysisId": 5334812,
    "appAnalysisId": 148038,
    "analysisName": "RMS_EDM_UIQ_UIAutomation: ACCOUNT: EQ_WS_WC_POL",
    "analysisType": "DLM",
    "peril": "EQ",
    "metricTypes": ["POLICY_STATS", "ELT", "EP", "STATS", "POLICY_EP"]
  },
  {
    "analysisId": 5334752,
    "appAnalysisId": 148039,
    "analysisName": "RMS_EDM_UIQ_UIAutomation: ACCOUNT: EQ_WS_WC_POL",
    "analysisType": "DLM",
    "peril": "EQ",
    "metricTypes": ["EP", "STATS", "ELT"]
  }
]

January 2025

🥥
Highlights

Admin Data API

Risk Data API

Exposures

Report View

Search Report View

🥥Highlights

Admin Data API

Risk Data API

Exposures

Report View

Search Report View

🥥
Highlights