Risk Modeler API FAQs

When should I use the Platform APIs?

  • If you are a licensed Risk Modeler tenant and developing a new application, Moody's encourages you to use the Platform APIs. Moody's Platform APIs deliver many new and powerful features as well as existing Risk Modeler API features.
  • If you are a Risk Modeler tenant that is already using Risk Modeler API endpoints in your application, you can continue to use those Risk Modeler resources, but Platform APIs for all new features.
  • If you are an UnderwriteIQ tenant that needs to immediately implement an application to manage underwriting workflows, continue to use the Risk Modeler API. The Platform APIs will support Exposure Batch and User-defined Workflow operations in the near future.

How do I create EDMs?

One advantage of the Platform APIs is that they provide for greater, more granular control over your exposure data. Platform's Risk Data API enables tenants to manage access to their exposure data using exposure sets. An exposure set is a securable that defines group-based access controls to all the exposures in that exposure set.

  1. Create an exposure set using the Risk Data API's Create Exposure Set operation (/platform/riskdata/v1/exposuresets).
  2. Create a database using the Data Bridge API's Create Database operation (/databridge/v1/sql-instances/{instanceName}/Databases). This database is hosted on Data Bridge.
  3. Register the EDM using the Risk Data API's Register EDM operation /riskdata/v1/dataservers/{serverId}/databases/{databaseId}/register). You will need to specify the serverId and databaseId of the hosted database and the exposureSetId of the exposure set. Once registered the EDM is accessible using the Risk Modeler API, UnderwriteIQ API, and Platform APIs.

The Risk Modeler API automatically creates an exposure set whenever you create an EDM.

  1. Create an EDM using the Risk Modeler API's Administer EDM operation (/riskmodeler/v1/datasources).
  2. Register the EDM using Risk Modeler's Register EDM operation (/riskmodeler/v2/data-bridge/register). You will need to specify the serverId and databaseId of the database and the exposureSetId of the exposure set. Once registered the EDM is accessible using the Risk Modeler API, UnderwriteIQ API, and Platform APIs.