Overview

Moody's RMS APIs enable authenticated clients to securely connect to Intelligent Risk Platform and perform risk modeling and data management tasks.

The Intelligent Risk Platform is a cloud-based platform for advanced modeling and risk analysis tasks. Licensed UnderwriteIQ tenants may access and use the Risk Modeler API to perform underwriting workflows.

Step 1: Obtain host name and API key

Intelligent Risk Platform manages the authentication and authorization of clients by means of API keys. An API key is a token that uniquely identifies a client application. The client must pass a valid API key to the Intelligent Risk Platform whenever it makes a request. To learn more, see Authentication and Authorization.

The API key specifies the access rights and permissions granted to the client. To learn more, see Groups and Roles.

During onboarding, your tenant administrator will provide you with a host name and an API key:

• The host name identifies the data center hosting your company's UnderwriteIQ application instance. One of api-euw1.rms.com or api-use1.rms.com.
• The API key is a token that enables Intelligent Risk Platform to authenticate requests. Every API key is tied to a specific tenant and assigned to one or more groups.

If you do not know have an API key or do not know the name of your host environment, contact your tenant administrator.

Step 2: Understand RMS API operation endpoints

A resource a callable unit of a RESTful API that consists of an HTTP request method and an endpoint (URL) that consists of a scheme, host, and path:

The method specifies the HTTP request method (AKA http verb) that specifies the action to be performed on a resource data set. Platform APIs support GET, POST, PUT, and DELETE requests. Depending on the HTTP requet method specified, the resource retrieves, creates, updates, or deletes an instance of the specified resource data set. Some POST and PUT requests and all GET requests are idempotent.

The host identifies the data center that hosts your company's tenant instance: api-euw1.rms.com or api-use1.rms.com. The host is sometimes referred to as the {host} variable in Postman collections and some code samples. Whenever you see the {host} variable in an example, you must substitute the correct host name.

The path consists of an app path, api path, version path, and resource path.

• The app path identifies the Moody's RMS application. For example, platform or databridge.
• The api path identifies the Platform API. Platform APIs include riskdata, admindata, tenantdata, and import. Each API includes resources that enable you to manage a distinct functional area of the Intelligent Risk Platform.
• The version path identifies the version number of the resource. Platform APIs are periodically upgraded and versioned.
• The resource path identifies Intelligent Risk Platform resource data set, the data set accessible through the endpoint. The resource path may include path parameters and query parameters. Our API Reference documentation provides detailed information about the parameters that may be defined in the path of each service.

📷

Resource Groups

Risk Modeler API endpoints that initiate workflow jobs accept an optional custom header X-Rms-Resource-Group-Id that can be used to specify ID number of a resource group. Intelligent Risk Platform utilizes resource groups to ensure that a tenant's resource quota is correctly allocated within the tenant's organization. To learn more, see Resource Groups.

Step 3: Make a test API request

You can now confirm that the API key is working by making a request to Intelligent Risk Platform.

The Get results service enables you to request information about one or more Exposure Data Modules (EDMs). The EDM is a cloud-based data structure for storing exposure data.

curl --location --request GET 'https://{host}/riskmodeler/v1/datasources' \
--header 'Authorization: XXXXXXXXXXX'

The Exposure Data Module (EDM) is a cloud-based database structure that stores the detailed exposure, hazard, and financial information for use in catastrophe modeling. Exposure data stored in an EDM may be used for risk analysis or for migration to other RMS products. A tenant may own multiple EDMs on multiple servers.

Your ability access and view specific EDMs is determined by the API key that you provide to the service. Every API key is tied to one or more groups and your ability to access specific EDM data sources is determined by the API key specified in the Authorization header.

A successful request returns information about the specified EDM including the datasourceId, datasourceName, ownerId, and metrics attributes.

{ 
  "datasourceId": 345, 
  "datasourceName": "my_edm", 
  "dbType": 3, 
  "permissionType": 12, 
  "isDefault": false, 
  "metrics": { 
    "AggPortCount": 0, 
    "LastModified": "2020-02-21 19:40:15.19", 
    "TreatyCount": 0, 
    "Size": "500 MB", 
    "EDMVersion": "18", 
    "PortCount": 0, 
    "LocCount": 2, 
    "AcctCount": 10, 
    "CedantCount": 0 
  }, 
  "ownerId": "XXXXXXXXXX", 
  "owner": "XXXXXXXXXX" 
} 

A tenant may maintain multiple EDMs; consequently, many Risk Modeler operations require that you specify the name of an EDM (the dataSourceName) as a query parameter that is appended to the operation path.# Overview

Moody's RMS APIs enable authenticated clients to securely connect to Intelligent Risk Platform and perform risk modeling and data management tasks.

The Intelligent Risk Platform is a cloud-based platform for advanced modeling and risk analysis tasks. Licensed UnderwriteIQ tenants may access and use the Risk Modeler API to perform underwriting workflows.

Step 1: Obtain host name and API key

Intelligent Risk Platform manages the authentication and authorization of clients by means of API keys. An API key is a token that uniquely identifies a client application. The client must pass a valid API key to the Intelligent Risk Platform whenever it makes a request. To learn more, see Authentication and Authorization.

The API key specifies the access rights and permissions granted to the client. To learn more, see Groups and Roles.

During onboarding, your tenant administrator will provide you with a host name and an API key:

• The host name identifies the data center hosting your company's UnderwriteIQ application instance. One of api-euw1.rms.com or api-use1.rms.com.
• The API key is a token that enables Intelligent Risk Platform to authenticate requests. Every API key is tied to a specific tenant and assigned to one or more groups.

If you do not know have an API key or do not know the name of your host environment, contact your tenant administrator.

Step 2: Understand RMS API operation endpoints

A resource a callable unit of a RESTful API that consists of an HTTP request method and an endpoint (URL) that consists of a scheme, host, and path:

The method specifies the HTTP request method (AKA http verb) that specifies the action to be performed on a resource data set. Platform APIs support GET, POST, PUT, and DELETE requests. Depending on the HTTP requet method specified, the resource retrieves, creates, updates, or deletes an instance of the specified resource data set. Some POST and PUT requests and all GET requests are idempotent.

The host identifies the data center that hosts your company's tenant instance: api-euw1.rms.com or api-use1.rms.com. The host is sometimes referred to as the {host} variable in Postman collections and some code samples. Whenever you see the {host} variable in an example, you must substitute the correct host name.

The path consists of an app path, api path, version path, and resource path.

• The app path identifies the Moody's RMS application. For example, platform or databridge.
• The api path identifies the Platform API. Platform APIs include riskdata, admindata, tenantdata, and import. Each API includes resources that enable you to manage a distinct functional area of the Intelligent Risk Platform.
• The version path identifies the version number of the resource. Platform APIs are periodically upgraded and versioned.
• The resource path identifies Intelligent Risk Platform resource data set, the data set accessible through the endpoint. The resource path may include path parameters and query parameters. Our API Reference documentation provides detailed information about the parameters that may be defined in the path of each service.

📷

Resource Groups

Risk Modeler API endpoints that initiate workflow jobs accept an optional custom header X-Rms-Resource-Group-Id that can be used to specify ID number of a resource group. Intelligent Risk Platform utilizes resource groups to ensure that a tenant's resource quota is correctly allocated within the tenant's organization. To learn more, see Resource Groups.

Step 3: Make a test API request

You can now confirm that the API key is working by making a request to Intelligent Risk Platform.

The Get results service enables you to request information about one or more Exposure Data Modules (EDMs). The EDM is a cloud-based data structure for storing exposure data.

curl --location --request GET 'https://{host}/riskmodeler/v1/datasources' \
--header 'Authorization: XXXXXXXXXXX'

The Exposure Data Module (EDM) is a cloud-based database structure that stores the detailed exposure, hazard, and financial information for use in catastrophe modeling. Exposure data stored in an EDM may be used for risk analysis or for migration to other RMS products. A tenant may own multiple EDMs on multiple servers.

Your ability access and view specific EDMs is determined by the API key that you provide to the service. Every API key is tied to one or more groups and your ability to access specific EDM data sources is determined by the API key specified in the Authorization header.

A successful request returns information about the specified EDM including the datasourceId, datasourceName, ownerId, and metrics attributes.

{ 
  "datasourceId": 345, 
  "datasourceName": "my_edm", 
  "dbType": 3, 
  "permissionType": 12, 
  "isDefault": false, 
  "metrics": { 
    "AggPortCount": 0, 
    "LastModified": "2020-02-21 19:40:15.19", 
    "TreatyCount": 0, 
    "Size": "500 MB", 
    "EDMVersion": "18", 
    "PortCount": 0, 
    "LocCount": 2, 
    "AcctCount": 10, 
    "CedantCount": 0 
  }, 
  "ownerId": "XXXXXXXXXX", 
  "owner": "XXXXXXXXXX" 
} 

A tenant may maintain multiple EDMs; consequently, many Risk Modeler operations require that you specify the name of an EDM (the dataSourceName) as a query parameter that is appended to the operation path.