Migrate to Platform APIs
Build solutions using the Platform APIs
Overview
Moody’s strongly recommends that licensed Risk Modeler and UnderwriteIQ tenants transition to Platform APIs instead of the Risk Modeler APIs for all future projects.
The Platform APIs are a collection of REST APIs that are designed to enable Intelligent Risk Platform tenants to maximize the productivity of their organizations by automating their underwriting workflows. Using the Platform APIs, organizations can define and run end-to-end workflows that can programmatically import exposure data, model that data, and exposure result data to a variety of outputs.
This guide provides guidelines for migrating workflows based on Risk Modeler API to workflows
Advantages of Platform APIs
- Supports existing Risk Modeler API operations.
- Improves existing Risk Modeler API operations.
- Delivers new features that are unavailable in the Risk Modeler API.
Migrating to Platform APIs
This section identifies standard Risk Modeler and UnderwriteIQ workflows, the Risk Modeler API operations that support these workflows, and the equivalent Platform API operations.
Correspondences
Unlike the Risk Modeler API, which defines all API operations in a single API, the Platform APIs is a collection of APIs that collect API operations in different APIs.
Risk Data API
The majority of Risk Modeler API operations directly map to operations in the Risk Data API.
In the Platform APIs, workflows are generally managed by means of discreet jobs.
| Risk Modeler | /riskmodeler Endpoint | Platform | PL APIs Endpoint |
|---|---|---|---|
| Get Metrics | /v2/analyses/{analysisID}/metrics | Get EP Metrics | /riskdata/v1/analyses/{analysisId}/ep |
| Get Statistics | /v1/analyses/{id}/stats | Get EP Statistics | /riskdata/v1/analyses/{analysisId}/stats |
| Get Metrics | /v2/analyses/{analysisID}/metrics | Get Marginal EP Metrics | /riskdata/v1/analyses/{analysisId}/marginal-ep |
| Get Metrics | /v2/analyses/{analysisID}/metrics | Get Marginal Statistics | /riskdata/v1/analyses/{analysisId}/marginal-stats |
| Get Workflows | /v1/workflows | Get Risk Data Job | /riskdata/v1/jobs/{jobId} |
Import API
In the Import API, import workflow are managed using using the Create Import job.
| Risk Modeler | /riskmodeler Endpoint | Platform | PL APIs Endpoint |
|---|---|---|---|
| Import Exposures from File | /v1/imports | Create Import Job (MRI) | /import/v1/jobs |
| Import Exposures from File | /v1/imports | Create Import Job (ALM) | /import/v1/jobs |
| Upload EDM | /v1/uploads/{uploadId}/edm | Create Import Job (EDM) | /import/v1/jobs |
| Create Import Job (OED) | /import/v1/jobs | ||
| Create Import Job (CEDE) | /import/v1/jobs | ||
| Upload RDM | /v1/uploads/{uploadId}/rdm | Create Import Job (RDM_DB) | /import/v1/jobs |
| Upload RDM | /v1/uploads/{uploadId}/rdm | Create Import Job (RDM) | /import/v1/jobs |
| Get Workflows | /v1/workflows | Get Import Job | /import/v1/jobs/{jobId} |
Export API
In the Export API, import workflow are managed using using the Create Export job.
| Risk Modeler | /riskmodeler Endpoints | `` | /export Endpoints |
|---|---|---|---|
| Export Data Module to File | /v2/exports | Create Export Job (EDM) | /export/v1/jobs |
| Create Export Job (EXPSRE_RSRC) | /export/v1/jobs | ||
| Export Data Module to File | /v2/exports | Create Export Job (RDM) | /export/v1/jobs |
| Export Data Module to File | /v2/exports | Create Export Job (RESULTS) | /export/v1/jobs |
| Export Data Module to File | /v2/exports | Create Export Job (LOC_RSLTS) | /export/v1/jobs |
| Create Export Job (ROLLUP_RSLTS) | /export/v1/jobs | ||
| Get Workflows | /v1/workflows | Get Export Job | /export/v1/jobs/{jobId} |
Batch API
| Risk Modeler | /riskmodeler Endpoints | Batch | /export Endpoints |
|---|---|---|---|
| Process Custom Workflow | /riskmodeler/v1/workflows | Create Batch Job | /batch/v1/jobs |
| Get Workflows | /riskmodeler/v1/workflows | Get Batch Job | /batch/v1/jobs/{jobId} |
