Touchstone Re 2023 API Reference
Overview

The Touchstone Re APIs enables you to integrate many of the core functions of Touchstone Re into your own applications.

The APIs consists of several services:

Service Description Methods
ActivityManagementService

Retrieve and delete activities and retrieve activity logs.

Activities are actions that you perform in Touchstone Re, for example, running analyses.

CompanyManagementService

Create, retrieve, and delete Touchstone Re companies. Additionally, copy, create, and retrieve exposure sets.

A company is a container for related exposure data, loss data, reinsurance programs, company loss sets, and loss analyses.

An exposure set is a collection of exposure data such as sums insured, risk count, premium, rate, payroll, and market share data. Exposure sets are associated with companies. Companies may contain many exposure sets.

DataExportService

Export aggregate loss analyses results to detailed loss files (DLFs) in binary or comma-separated values (CSV) format. Additionally, export program aggregate loss analysis results to the Analyze Re application.

You can use DLFs in binary format in both Touchstone Re and CATRADER. You can use DLFs in CSV format in CATRADER.

You can run aggregate loss analyses on a reinsurance program or on a portfolio of reinsurance treaties.

ObjectManagementService

Retrieve zone sets and event-based adjustment factor sets.

A zone set is a collection of one or more zones that you can use when you run analyses. A zone is a region, country, area, or subarea. For example, you can create a zone set named "Pacific Northwest" that comprises three zones: the U.S. state of Oregon, the U.S. state of Washington, and the Canadian Province of British Columbia.

An event-based adjustment factor enables you to adjust ground up modeled loss estimates. If you license event-based adjustment factors, you can specify factors for each event or each combination of event, area, and line of business associated with a given model.

You manage zone sets and event-based adjustment factors in the Touchstone Re Administration Console.

ProjectManagementService Retrieve currency exchange rate sets to use during analyses.
ReinsuranceAggregateLossAnalysisService

Retrieve event sets and submit loss analyses to evaluate a reinsurance program, multiple reinsurance programs in a company, or a portfolio of reinsurance treaties.

You can subsequently query the Touchstone Re databases to retrieve analysis results.  

ReinsuranceCompaniesExport Export one or more Touchstone Re companies.
ReinsuranceCompanyLossSetManagementService

Retrieve or delete company loss sets. Additionally, compute a loss market share based on a company loss file set.

A company loss set can include a set of company loss files (CLFs) or company loss associations. You can export company loss data from Touchstone in two ways:

  • Export company loss files and then import the files in Touchstone Re.
  • Create a company loss association. When you create a company loss association, Touchstone writes the loss data to an AIRCompanyLoss database that is accessible to Touchstone Re.
  • Convert CSV loss files generated from Catrader or Touchstone Re into Binay ULF loss files.
  • Manage all loss files in one single repository. Identify loss files based on usage. Thereby, remove old or unused loss files and cleanup your disk space.
ReinsuranceDataImportService

Import company data from a company XML file that you obtained from CATRADER or from another Touchstone Re instance. Additionally, import company loss file (CLF) sets, UNICEDE/2 files, and exposure data for mainland China, and copy existing companies.

ReinsurancePortfolioManagementService

Create, retrieve, update, copy, and delete portfolios.

A portfolio in Touchstone Re is a collection of reinsurance treaties (or layers) sourced from various reinsurance programs.

ReinsuranceProgramManagementService

Copy, create, retrieve, update, and delete reinsurance programs. Retrieve and update model-specific exceedance probability curve adjustments for a given reinsurance program. Manage relationships between reinsurance programs. Additionally, retrieve the catastrophe bond note values that you need to create catastrophe bond reinsurance programs.

A reinsurance program is a collection of one or more layers or reinsurance treaties that you can use when you run analyses.

An EP adjustment is an amount or percentage that Touchstone Re uses to recalculate the EP curve during a loss analysis.

A relationship defines the association between two reinsurance programs. Specifically, the relationship specifies which program inures to the benefit of the other program, the financial perspective of the association, and the relavant participation level. One reinsurance program may have many relationships.

Catastrophe bond note values provide information about catastrophe bond reinsurance programs, such as the sponsors and covered perils associated with the program.

SecurityService

Retrieve business units, SQL instances, and the security policy.

To submit a request to the Touchstone Re APIs, you must supply the sequential identifier of the business unit and SQL Server instance that is relevant to the request.