Overview
Exchange Data API exposes a collection of API operations to set up, manage, and utilize data exchange resources, allowing users to exchange data between Intelligent Risk Platform tenants without the need for repetitive/time-consuming offline steps.
The Exchange Data API enables Intelligent Risk Platform tenants to share an EDM and DLM/HD analysis results with other customers on other Intelligent Risk Platform tenants or with Moody's RMS Support.
For example, a primary insurer or reinsurance broker can share an EDM (exposure data) with reinsurers for purposes of contract pricing.
Data exchanges are part of your tenant's import/export quota, which determines how many concurrent data management jobs your tenant can run.
Data Exchange is an Intelligent Risk Platform application that enables Intelligent Risk Platform tenants to share exposure or analysis data with other tenants or other business entities. For more information, see Data Exchange in Help Center.
Exchange Data Objects
Exchange Data API operations are managed via three core objects: share requests, share keys, and recipients.
- A share key is a unique, system-generated key (ID number) that identifies an Intelligent Risk Platform tenant, which is authorized to share exchange data with other tenants using Risk Data Exchange. A tenant may specify the share key of another tenant to "whitelist" that tenant.
- A recipient is an Intelligent Risk Platform tenant has been approved ("whitelisted") to share exchange data with another tenant through Risk Data Exchange. The recipient is identified by a unique share key (recipientShareKey), a public name (shareKeyName), and the email address of the Data Exchange Admin responsible for reviewing share requests for that tenant.
- A share request is a request to transfer a copy of exposure or analysis data to another Intelligent Risk Platform tenant via Risk Data Exchange. No data is shared between tenants unless both the sender and recipient approve the share request.
Limitations
The current version of Data Exchange allows you to share a single EDM database or share results from DLM or HD analyses on Intelligent Risk Platform Modeler, as well as share multiple entities across regions and tenants.
Note
Data shared through this API are copies of data. They are not live versions that are dynamically updated as the source data changes.
Exchange Data API Roles
Intelligent Risk Platform defines two roles for Exchange Data API operations: Platform—Data Exchange User and Data Exchange Admin.
Operation | Data Exchange User | Data Exchange Admin |
---|---|---|
Search Share Keys | Yes | Yes |
Get Share Key | Yes | Yes |
Create Share Key | No | Yes |
Update Share Key | No | Yes |
Search Recipients | Yes | Yes |
Get Recipient | Yes | Yes |
Create Recipient | No | Yes |
Update Recipient | No | Yes |
Search Share Request | Yes | Yes |
Get Share Request | Yes | Yes |
Create Share Request | Yes | Yes |
Update Share Request | Yes | Yes |
Review Share Request | No | Yes |