What's New in the Touchstone^® 2022 (10.0) APIs

The following sections describe the changes included in the Touchstone 10.0 APIs:

For a list of all the Touchstone functions available through the APIs, see Features of the Touchstone APIs.

Highlights

In Touchstone 2022 APIs, we have expanded the APIs in the following areas:

Ability to create and manage reinsurance programs using the Touchstone Reinsurance API service. Previously, Touchstone allowed users to create and modify reinsurance programs only within the application; and the public API users only had the option to import the existing reinsurance programs. With this update, you can programmatically create a new reinsurance program, add one or multiple reinsurance treaties to the existing reinsurance program, and modify the existing treaties in a reinsurance program. In addition, you can define new treaty terms for an existing reinsurance treaty and filter treaties by geography.
Append the peril set codes of the Severe Thunderstorm peril in your detailed loss analysis request. We have introduced sub-peril support in the Verisk Severe Thunderstorm Model for the United States. This enables you to individually code exposures for hail, tornado, and straight-line winds and run detailed loss analyses individually for these sub-perils. To support this model update, we have implemented unique enumeration values such as the straight-line winds = 8388608, tornado = 2097152, and hail = 1048576 codes for the severe thunderstorm peril class in the AIR.Services.Common.Data namespace

New Objects and Properties

We have implemented the following namespace, objects, and properties for Touchstone 2022 (10.0).

Objects or Property	Description
AIR.InformationModel.Reinsurance.Data Namespace
ReinsuranceTreaty	The Information Model service now includes a Reinsurance Data namespace to associate a reinsurance treaty with a reinsurance program and store the reinsurance treaty information. This namespace contains two new classes: the ReinsuranceTreaty and ReinsuranceProgramTreaty classes. The ReinsuranceTreaty class stores the financial perspectives and treaty terms for all the reinsurance treaties associated with the parent reinsurance program. When you create a new treaty or modify the existing treating information, the changes go into the ReinsuranceTreaty class for the specific reinsurance program identifier. This class includes the following properties: AggregateLimit AggregateRetention AppliesToEvent AppliesToEventFilter AppliesToGeo AppliesToGeoFilter AppliesToLineOfBusiness CededAmount CedentName CoinsuranceAmount CurrencyCode Description ExpirationDate InceptionDate IndustryLossMaximum IndustryLossMinimum InuringSequenceNumber LossesPaid LossModificationFactor MatchLossToLimit OccurrenceLimit OccurrenceRetention ParticipationGross ParticipationNet Perils PlacedAmount PortfolioLossMaximum PortfolioLossMinimum PreferredExposureTypeCode PremiumEstimated ProgramName ProgramSid ProjectSid ReinsTargetTypeCode Reinstatement ReinstProvisionalAmount ReinstProvisionalTime ReinsurerName RiskAggregateLimit RiskAggregateRetention RiskLimit RiskLimitReinstatement RiskRetention RowNumber StartingEventNumber SubmitStatusCode TreatyID TreatyTypeCode
ReinsuranceProgramTreaty	The ReinsuranceProgramTreaty class captures the association between a reinsurance program and its collection of treaties. We have implemented the following properties for this class: Description ExposureViews ProgramName ProjectSid Treaties
Reinsurance Management Service Client
CreateReinsuranceProgram (CreateReinsuranceProgramRequest and CreateReinsuranceProgramResponse)	The CreateReinsuranceProgram method allows you to create a new reinsurance program at a time. The request requires a valid Business Unit SID, SQL Server instance identifier, and ProjectSID that uniquely identifies the project in which you want to create the reinsurance program. The CreateReinsuranceProgramRequest class contains the following properties: Description Name ProjectSid The CreateReinsuranceProgramResponse class contains the following property: ProgramSid
CreateReinsuranceTreaty (CreateReinsuranceTreatyRequest and CreateReinsuranceTreatyResponse)	The CreateReinsuranceTreaty method allows you to create a new reinsurance treaty in the existing reinsurance program at a time. You can add multiple treaties to a reinsurance program. The CreateReinsuranceTreatyRequest class contains the following property: Treaty The CreateReinsuranceTreatyResponse class contains the following property: Sid
GetReinsurancePrograms (GetReinsuranceProgramRequest and GetReinsuranceProgramResponse)	The GetReinsurancePrograms method enables you to fetch the reinsurance programs and treaties information associated with a reinsurance program or multiple reinsurance programs in a request. The request requires you to provide a valid project identifier in Touchstone that contains the reinsurance programs. The GetReinsuranceProgramRequest class contains the following property: ProjectSid The GetReinsuranceProgramsResponse class contains the following property: ReinsurancePrograms
UpdateReinsuranceTreaty (UpdateReinsuranceTreatyRequest and UpdateReinsuranceTreatyResponse)	The UpdateReinsuranceProgram method enables you to modify the existing terms in a reinsurance program. The UpdateReinsuranceTreatyRequest class contains the following property: Treaty The UpdateReinsuranceTreatyResponse class contains the following property: Sid
DeleteReinsuranceProgram (DeleteReinsuranceProgramRequest and DeleteReinsuranceProgramResponse)	The DeleteReinsuranceProgram method deletes the treaties in the existing reinsurance program. The DeleteReinsuranceTreatyRequest class contains the following property: TreatySid

Changed Objects and Properties

We have not modified any objects and properties for Touchstone 2022.

Deprecated/Removed Objects, Enums, and Properties

We have not deprecated any objects, enumerations, or properties for Touchstone 2022.

What's New in the Touchstone^® 2021 (9.0) APIs

The following sections describe the changes included in the Touchstone 9.0 APIs:

Highlights
New objects and properties
Changed objects and properties
Deprecated/Removed objects, enums, and properties

For a list of all the Touchstone functions available through the APIs, see Features of the Touchstone APIs.

Highlights

In Touchstone 2021, AIR has expanded the public APIs to enable you to:

Specify and delete multiple activities in the Activity Management API.
Obtain validation error messages when importing exposure data in Touchstone using the Activity Management API.
Export company loss files (CLFs) and company loss association (CLAs) with additional financial perspectives, including Workers' Compensation data and Maximum Any One Life (MAOL) limits (1 through 4) when exporting .
Append and modify Peril codes for Hail, Straight Line Wind, and Tornado perils at the exposure view and contract levels.
Save loss results in any supported currency. AIR has included support for a new currency code Bolivar Fuerte (VEF) in addition to the existing currency code Belarus Ruble (BYR), and includes new exchange rate for Venezuela currency.
Import custom event frequency and vulnerability sets catalogs for use with AIR models in the Detailed Loss Analysis. Thereby, you can determine the impact of losses on different events and vulnerabilities relevant to your analysis.
Export loss analyses results in Touchstone to AnalyzeRe Cloud.
AIR has updated the weapon type categories for the Event Set Management API.
Determine the ring that accumulated the highest loss for exposures surrounded with several rings in the Dynamic Ring and Grid Ring analyses.
Obtain accurate addresses for locations geocoded using the Exposure Management API in Touchstone.
Perform a Detailed Loss analysis with the Marine Craft Geocode in the Loss Analysis API.

Beginning with Touchstone 2021, AIR no longer supports:

The Non-Catastrophe loss analyses functionality including Non-Catastrophe Peril Analysis section on Detailed Loss Analysis and Results user interface. The Administration Console user interface no longer shows the Non-Catastrophe settings in Loss Default, Loss Analysis Template, Custom Loss Template, and Loss Cost Adjustment Factor options.
The Association for Cooperative Operations Research and Development (ACORD) functionality associated with the insurance industry.
The SevereThunderstormLossOptions sub-class in the Detailed Loss Analyses class. Now you can append the Severe Thunderstorm perils directly in the Loss Analysis Options class. For more information, see Perils in the Loss Analysis API Namespace.

The ReinsuranceManagementServiceClient API Namespace in Touchstone is only for future use. Do not apply change management process using the following methods and classes:

CreateReinsuranceProgram (including CreateReinsuranceProgramRequest and CreateReinsuranceProgramResponse classes)

CreateReinsuranceTreaty (including CreateReinsuranceTreatyRequest and CreateReinsuranceTreatyResponse classes)

GetReinsurancePrograms (including GetReinsuranceProgramsRequest and GetReinsuranceProgramsResponse classes)

UpdateReinsuranceTreaty (including UpdateReinsuranceTreatyRequest and UpdateReinsuranceTreatyResponse classes)

DeleteReinsuranceTreaty (including DeleteReinsuranceTreatyRequest and DeleteReinsuranceTreatyResponse classes)

The CommonExposureData and LossAnalysis Namespaces in Touchstone includes additional properties such as the loss analysis output options and financial terms for the layer combined deductibles, layer deductibles, and coverages functions. Do not apply change management process using these properties.

New Objects and Properties

AIR has added the following objects and properties for Touchstone 2021 (9.0).

Objects or Property	Description
ActivityManagementServiceClient
SubmitDeleteActivities including (SubmitDeleteActivitiesRequest and SubmitDeleteActivitiesResponse)	The new SubmitDeleteActivities method lets you specify and delete multiple activities in the Activity Management API. The deleted activities appear with the status code as 'DEL' on the Touchstone user interface. And, after a bit, the deleted activities are no longer available in Touchstone. AIR has implemented new SubmitDeleteActivitiesRequest and SubmitDeleteActivitiesResponse classes to support with the deleting multiple activities. The request class contains the following property. ActivitySids Property The response class contains the following properties. ActivitySid Property Errors Property AIR has implemented a new DeleteActivityError sub-class in the response class to monitor activities that failed the request. This sub-class contains the following properties: DeleteActivitySid Error The DeleteActivitySid property contains the error message associated with the unique sequential identifier of the activity that failed to delete.
GetImportCombinedLog including (GetImportCombinedLogRequest and GetImportCombinedLogResponse)	The new GetImportCombinedLog method fetches a log file containing the summary of validation error messages for the Data Import operation. The log file contains four sections to report the summary of errors, import operation statistics, quality of exposures, and import configuration options. You can create a macro to programmatically handle validation error messages when importing exposures, or generate a validation report and analyze the pattern of errors in Reinsurance, Business, or Geocoding, and thereby, enhance the quality of input exposures. The GetImportCombinedLogRequest class contains the following property. ActivitySid Property The GetImportCombinedLogResponse class returns a summary of the exported data. The response class includes the following properties. These properties are housed in the AIR.Services.ActivityMonitor.Data Namespace. BusinessErrors Property DataErrors Property ErrorsSummary Property GeocodingErrors Property ImportStatistics Property Options Property Warnings Property
ActivityMonitor Data
Activity Monitor Data	AIR has implemented a new Activity Monitor Data namespace to monitor the progress of the Data Import operation and generate statistics of the imported data. This namespace includes the following sub-classes, class, and enumeration to support the generating Combined Import Log file. DataErrorData Class DataSourceInformation Class DescriptionData Class ErrorData Class ErrorsSummaryData Class ErrorSummaryDescriptionData Class Header Class ImportOptions Class ImportStatisticsData Class LogImportOptionsData Class StatisticsData Class DataType Enumeration
Common Exposure Data
PerilSetCode	AIR has enabled the peril code for StraightLine Winds and added new peril codes for Hail and Tornado. Now you can specify the peril codes directly in the SubmitDetailedLossAnalysis Method and submit a detailed loss analysis request. Hail = 1048576 Tornado = 2097152 StraightLineWinds = 8388608
ExposureModifyOptions	AIR has implemented the following properties at the contract and exposure view level to uniquely identify the property before modifying perils. OriginalContractID Property OriginalExpView Property
UserGeoMatchlevel	The GeocodeLocations method in the Exposure Management API now includes a function to specify the user-provided geocode for locations geocoded using the AIR Geocoder. AIR has implemented the following property in the GeocodeLocationOutput class. This new property obtains the user-defined geocode value for a location to access the quality of address and then import the exposures and the associated premium geocodes into Touchstone. UserGeoMatchlevel Property
DataExportServiceClient
LossAnalysisExportOptions	Now you can choose whether you want to export the loss analyses results with the default AIR Analysis function at the time of a Detailed Loss analysis request. IsTargetHasAIRAnalysisApplied Property Now you can choose whether you want to include the Custom Frequency Sets function in the exported loss analyses results. IsTargetHasCustFreq Property To export the Detailed Loss Analyses results with AIR Models, specify the 'IsTargetHasAIRAnalysisApplied' property 'True' in the SubmitLossAnalysisExportRequest class.
DataExportServiceClient
SubmitLossResultToAnalyzeReExport (SubmitLossResultToAnalyzeReExportRequest and SubmitLossResultToAnalyzeReExportResponse Class)	The SubmitLossResultToAnalyzeReExport method enables you to export the Detailed Loss analyses in Touchstone to AnalyzeRe cloud. Touchstone clients require a valid authentication in order to access this feature. If you license the Analyze Re features in Touchstone (Re), AIR configures license information between applications. AIR has implemented a new AnalyzeReExportOptions class to configure the export options. This class contains the following properties: AnalysisSid Property ExtensionData Property FinancialPerspective Property MaximumCores Property MinimumCores Property ReportTypeCode Property S3BucketName Property S3PathPrefix Property TargetCatalogSize Property AIR has added a new ReportTypeCodes Enumeration, which contains the following fields: EventLossByGeoLOB EventLossByPortfolio EventLossByTreaty EventLossByTreatyGeoLOB AIR has added a new TargetCatalogSize Enumeration, which contains the following fields: AsIs HundredThousand AIR has implemented the SubmitLossResultToAnalyzeReExportRequest and SubmitLossResultToAnalyzeReExportResponse classes to support with exporting loss results from Touchstone to AnalyzeRe cloud. The SubmitLossResultToAnalyzeReExportRequest Class contains the following property: AnalyzeReExportOptions Property The SubmitLossResultToAnalyzeReExportResponse Class contains the following properties: ActivitySid Property S3BasePath Property
ReportTypeCodes	This enumeration class contains the loss perspectives used to specify in the export job. The class contains the following properties: EventLossByGeoLOB EventLossByPortfolio EventLossByTreaty EventLossByTreatyGeoLOB
TargetCatalogSize	This enumeration class defines the following target catalog size. AsIs HundredThousand
UserToIndustryLineOfBusinessMapping	Now you can specify Maximum Any One Life (MAOL) limits and Workers Compensation for the SubmitClfExportRequest and SubmitCompanyLossAssociationExportRequest classes and generate the MAOL limits data (1 through 4) and Workers' Compensation data for each company loss file. The SubmitCLFExport and SubmitCompanyLossAssociationExport methods contain the UserToIndustryLineOfBusinessoptions class to specify characteristics of the Loss Analysis file that you want to export to a Company Loss File (CLF). AIR has added two new boolean properties to the existing UserToIndustryLineOfBusinessoptions class: ISMAOL IsWorkersComp Thereby, enabling you to analyze granular financial impact for exported loss files.
Exposure Concentration Analysis Data
RingAnalysisOptions	The existing SubmitRingExposureConcentrationAnalysis Method in the ExposureConcentrationAnalysisServiceClient now includes the RemoveOverlaps function in an exposure set with rings of same latitude and longitude in a close proximity. AIR has implemented the following property in the RingAnalysisOptions Class. RemoveOverlaps
FinancialPerspectiveToFindHighestLossRing	AIR has implemented this enumeration class to determine the ring that is accumulating the highest loss after removing overlapping rings in an crowded . This class contains the following objects: Gross GroundUp PostCATNet PreCATNet
Loss Analysis Data
IsApplyAIRAnalysis	AIR has implemented this property in the DetailedLossAnalysisOptions class. This function enables you to select or remove the AIR Analysis option at the time of the Detailed Loss analysis. If you do not want to include AIR Analysis in your Detailed Loss analysis, specify this property as 'False'.
MoveMarineCraftGeocodesToCoast	AIR has implemented this property in the DetailedLossAnalysisOptions Class to enable you to move Marine Craft Geocodes To Coast in the Detailed Loss Analysis.
LossAnalysisServiceClient
GetCustomFrequencySets including (GetCustomFrequencySetsRequest and GetCustomFrequencySetsResponse)	The new GetCustomFrequencySets lets you import Custom Event Frequency catalogs for each AIR model at the time of a Detailed Loss Analysis to analyze loss results. This method enables you to tailor events sets and analyze the impact of loss results on these different events. AIR has implemented the GetCustomFrequencySetsRequest and GetCustomFrequencySetResponse classes to support with the import of custom event frequencies into Touchstone. The request class includes the Paging details such as page count, page size, page number, and total number of event sets to import: PagingInfo Property The response class returns the custom frequency set name associated with a AIR model and the page details. The return class contains the following properties: CustomFrequencySets Property PagingInfo Property
GetCustomVulnerabilitySets including (GetCustomVulnerabilitySetsRequest and GetCustomVulnerabilityResponse)	The new CustomVulnerabilitySets enables you to import Custom Vulnerability Sets for each AIR model at the time of a Detailed Loss Analysis. AIR has implemented the GetCustomVulnerabilitySetsRequest and GetCustomVulnerabilitySetsResponse classes to support with the import of custom vulnerability sets into Touchstone. The request class includes the page details such as page count, page number, and the total number of custom vulnerability records to import per page: PagingInfo Property The response class returns the vulnerability set name associated with a AIR model and the page details. This class includes the following properties: CustomVulnerabilitySets Property PagingInfo Property
SecuirtyServiceClient
ResourceAllocation	AIR has added the following property to the existing ResourceAllocation class. ResourceTypesField

Changed Objects and Properties

AIR has modified the following objects and properties for Touchstone 9.0.

Objects	Description
DeliveryTruck_6_ton_TNT	AIR has renamed the existing object 'DeliveryTruck_6_ton_TNT' as 'SmallTruck_6_ton_TNT' for the EventSetManagementServiceClient. Use the updated weapon type in the SubmitRingResultToInternationalDeterministicTerrorismEventSet Method to initiate the API service call.

Deprecated/Removed Objects, Enums, and Properties

AIR has not deprecated any objects, enumerations, or properties for Touchstone 9.0.

Objects	Description
Non-Catastrophe Loss Analyses in LossAnalysisServiceClient	Retiring Non-Catastrophe Loss Analyses due to low client-consumption rate. The following class members are removed: GetNonCatContractResults GetNonCatReinsuranceResults GetNonCatLayerResults GetNonCatLocationResults
SevereThunderstormLossOptions in LossAnalysisServiceClient	Removed the SevereThunderstormLossOptions property in Detailed Loss Analyses.
SubmitImportAcord in DataImportServiceClient	Retiring ACORD functionality in Touchstone UI. As part of this update, the following class members are removed from the DataImport API: SubmitImportAcordRequest SubmitImportAcordResponse ImportOptionsAcord

Objects

Description

Non-Catastrophe Loss Analyses in LossAnalysisServiceClient

Retiring Non-Catastrophe Loss Analyses due to low client-consumption rate. The following class members are removed:

GetNonCatContractResults
GetNonCatReinsuranceResults
GetNonCatLayerResults
GetNonCatLocationResults

SevereThunderstormLossOptions in LossAnalysisServiceClient

Removed the SevereThunderstormLossOptions property in Detailed Loss Analyses.

SubmitImportAcord in DataImportServiceClient

Retiring ACORD functionality in Touchstone UI. As part of this update, the following class members are removed from the DataImport API:

SubmitImportAcordRequest
SubmitImportAcordResponse
ImportOptionsAcord