Trident APIs

Trident APIs

1.0OAS 3.0

Trident Api’s WorkFlow Data -

API Base URL
  • Server 1:https://trident-api.connecttrident.com

    Generated server url

Security
api_key (apiKey)

An API key is a token that you provide when making API calls. Include the token in a header parameter called x-api-key.

Example: x-api-key: 123

Additional Information

Shell Submission

Creates a new shell submission. This is the initial step in the submission lifecycle. Validated with the BasicValidation group: insured, producer, and policy are mandatory; inside policy, effectiveDate, expiryDate, product, and territory are mandatory. All other reference objects (majorPeril, directAssumed, typeOfBilling, division, office, mop, typeOfPlacementBespoke) are optional — but when present each must carry at least one of id / code / description (see the reference-object rule in the API description).

post
https://trident-api.connecttrident.com/submission/base

Body

application/json

Shell cyber submission request. insured, producer, and policy are required. Other reference objects are optional but must carry at least one of id/code/description when present.

CyberSubmissionRequest

Base submission payload. Validated with the BasicValidation group: insured, producer, and policy are required. The remaining reference objects are optional, but each present one must satisfy the at-least-one-of id/code/description rule.

insuredobjectrequired

Required. Insured details; insureContacts.id identifies the insured contact downstream.

Show Child Parameters
producerobjectrequired

Required. Producer reference (send id or description).

Show Child Parameters
policyobjectrequired

Required. Policy node (dates + currency/product/territory references).

Show Child Parameters
majorPerilobject

Optional. Major peril (typically description, e.g. Cyber Property).

Show Child Parameters
directAssumedobject

Optional.

Show Child Parameters
typeOfBillingobject

Optional.

Show Child Parameters
divisionobject

Optional.

Show Child Parameters
officeobject

Optional.

Show Child Parameters
mopobject

Optional. Method of placement.

Show Child Parameters
typeOfPlacementBespokeobject

Optional.

Show Child Parameters
writtenLineinteger

Optional written line percentage

Example:100

Response

application/json

Submission created

CyberSubmissionResponse

Response object containing cyber submission details including policy information, status, and reference keys

policyStatusstringrequired

Current status of the policy

Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU

Example:Quote Preparation

policyNostringrequired

Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies

Match pattern:^[QP]\d{7}$

Example:Q0038456

referencestring | null

Business reference number for tracking purposes

Example:CYB-2026-001

policyKeystringrequired

Internal policy key identifier used for database references

Example:20894

policyActivityKeystring

Internal policy activity key identifier for tracking specific policy activities

Example:45632

policyActivityStatusstring

Status of the current policy activity

Allowed values:ActiveCompletedPendingCancelledQuote NTU

Example:Active

post/submission/base

Body

{ "insured": { "insureContacts": { "id": "2000887" } }, "producer": { "id": "2000556" }, "policy": { "effectiveDate": "2024-01-01", "expiryDate": "2025-01-01", "currency": { "id": "9" }, "product": { "description": "Cyber" }, "territory": { "id": "17" } }, "majorPeril": { "id": "11" }, "directAssumed": { "id": "1" }, "typeOfBilling": { "id": "1" }, "division": { "id": "8" }, "office": { "description": "Head Office Canada" }, "mop": { "id": "3" }, "typeOfPlacementBespoke": { "id": "1" }, "writtenLine": 100 }
 
application/json

Full Submission

Adds the full-submission detail to a policy. Validated with the FullValidation group. The full-specific fields are REQUIRED: underWriterDetails, riskRegulatoryLoctn, insuredDomicileCountry, insuredDomicileState, uSClassification, lloydsIndustrialSector, mosaicOccupation, possibleClashIdentified, stampUnderwriter, producingUnderwriter. The scalars periodTBA and submissionSanctionCheckComplete (each YES/NO), insuredRevenueTurnover (≥ 0) and rev.-Turnover are also required. Each reference object present must carry at least one of id / code / description.

post
https://trident-api.connecttrident.com/submission/full

Query Parameters

policyKeystring

Policy key returned by the base step (omit to create a new policy)

Example:21355

policyActivityKeystring

Policy activity key returned by the base step

Example:32634

Body

application/json

Full cyber submission request. Validated with the FullValidation group. The base parents (insured, producer, policy) are REQUIRED along with full-specific reference objects. Each reference object must carry at least one of id/code/description.

FullCyberSubmissionRequest

Full submission payload. Validated with the FullValidation group. The fields listed under required below are mandatory for this step. Every reference object present must satisfy the at-least-one-of rule.

underWriterDetailsobjectrequired

Required. Underwriter (typically description).

Show Child Parameters
riskRegulatoryLoctnobjectrequired

Required.

Show Child Parameters
insuredDomicileCountryobjectrequired

Required.

Show Child Parameters
insuredDomicileStateobjectrequired

Required.

Show Child Parameters
uSClassificationobjectrequired

Required. (Serialized JSON key uSClassification.)

Show Child Parameters
lloydsIndustrialSectorobjectrequired

Required.

Show Child Parameters
mosaicOccupationobjectrequired

Required.

Show Child Parameters
possibleClashIdentifiedobjectrequired

Required. Its code must be YES or NO.

Show Child Parameters
clashResponseobject

Optional.

Show Child Parameters
sBFClassobject

Optional. (Serialized JSON key sBFClass.)

Show Child Parameters
isThirdPartyCapacityDeployedobject

Optional.

Show Child Parameters
ourRoleobject

Optional.

Show Child Parameters
claimsAgreementPartyobject

Optional.

Show Child Parameters
stampUnderwriterobjectrequired

Required.

Show Child Parameters
producingUnderwriterobjectrequired

Required.

Show Child Parameters
periodTBAstringrequired

Required. Must be YES or NO.

Allowed values:YESNO

Default:NO

Example:NO

umrstring

Optional unique market reference

Example:B1234567890

submissionSanctionCheckCompletestringrequired

Required. Must be YES or NO.

Allowed values:YESNO

Default:YES

Example:YES

insuredRevenueTurnoverintegerrequired

Required. Must be ≥ 0.

>= 0

Example:0

signedLinenumber(double)

Optional

Example:100

rev.-Turnoverinteger(int64)required

Required. Serialized JSON key rev.-Turnover (backed by Java field revTurnover).

Example:10

Response

application/json

Full submission created

CyberSubmissionResponse

Response object containing cyber submission details including policy information, status, and reference keys

policyStatusstringrequired

Current status of the policy

Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU

Example:Quote Preparation

policyNostringrequired

Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies

Match pattern:^[QP]\d{7}$

Example:Q0038456

referencestring | null

Business reference number for tracking purposes

Example:CYB-2026-001

policyKeystringrequired

Internal policy key identifier used for database references

Example:20894

policyActivityKeystring

Internal policy activity key identifier for tracking specific policy activities

Example:45632

policyActivityStatusstring

Status of the current policy activity

Allowed values:ActiveCompletedPendingCancelledQuote NTU

Example:Active

post/submission/full

Body

{ "underWriterDetails": { "description": "Desai, stavan" }, "uSClassification": { "id": "6" }, "riskRegulatoryLoctn": { "id": "17" }, "insuredDomicileCountry": { "description": "Australia" }, "insuredDomicileState": { "description": "New South Wales" }, "lloydsIndustrialSector": { "id": "5" }, "mosaicOccupation": { "id": "198" }, "sBFClass": { "id": "4" }, "isThirdPartyCapacityDeployed": { "id": "2" }, "ourRole": { "id": "1" }, "claimsAgreementParty": { "id": "2" }, "stampUnderwriter": { "description": "Desai, stavan" }, "producingUnderwriter": { "description": "Desai, stavan" }, "possibleClashIdentified": { "code": "NO" }, "mop": { "id": "3" }, "typeOfPlacementBespoke": { "id": "1" }, "signedLine": 100, "insuredRevenueTurnover": 0, "periodTBA": "NO", "umr": "B1234567890", "submissionSanctionCheckComplete": "YES", "rev.-Turnover": 10 }
 
application/json

Quote Submission

Creates a complete cyber Quote submission with comprehensive validation. This endpoint processes all submission Quote details including Agreement information, Coverage details, Deducation Details.

Processing Time: 40-60 seconds

Validation Rules:

  • All quote fields are REQUIRED i.e [agreement(expecting agreement as code),

agreementActivity(expecting agreementActivity as code),

agreementSection(expecting agreementSection as code),

100%Limit,

solvencyIIClass(expecting solvencyIIClass as code),

aggregateLimit,

premium,

limitOccurrence,

100%Limit,

limitAggregate,

ratedPremium(100%),

deduction(expecting deductionType as code),

deductionRate(expecting deductionBasis as code),

regulatoryCode(expecting regulatoryCode as code),

codeSplitPc,

gELR,

productTemplateSectionToAdd,

bindProbability(expecting bindprobability as code),

majorPeril,

uMR]

  • All dates must be in ISO 8601 format (YYYY-MM-DD)
  • Currency codes must be valid ISO 4217 codes
  • Country codes must be valid ISO Alpha-2 or Alpha-3 codes
post
https://trident-api.connecttrident.com/submission/quote

Query Parameters

policyKeystring

Optional policy ID for updating existing policies

Example:POL123456

policyActivityKeystring

Optional policy activity ID for specific policy activities

Example:ACT789012

Body

application/json

Complete full cyber Quote submission request with all required and optional fields. This comprehensive request includes Agreement details, Coverage information, Deductions specifications, Codesplit details, and classification information.

QuoteRequest

sectionsarray[object]

List of sections in the quote

Show Child Parameters
productTemplateSectionToAddstring

Product template section to add

bindProbabilitystring

Bind probability

majorPerilstring

Major peril description

umrstring

Response

application/json

Full submission created successfully - Submission processed and created with all details

CyberSubmissionResponse

Response object containing cyber submission details including policy information, status, and reference keys

policyStatusstringrequired

Current status of the policy

Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU

Example:Quote Preparation

policyNostringrequired

Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies

Match pattern:^[QP]\d{7}$

Example:Q0038456

referencestring | null

Business reference number for tracking purposes

Example:CYB-2026-001

policyKeystringrequired

Internal policy key identifier used for database references

Example:20894

policyActivityKeystring

Internal policy activity key identifier for tracking specific policy activities

Example:45632

policyActivityStatusstring

Status of the current policy activity

Allowed values:ActiveCompletedPendingCancelledQuote NTU

Example:Active

post/submission/quote

Body

{ "sections": [ { "agreement": { "gELR": 50, "agreement": "AGR0000159", "agreementActivity": "AGR0000159-22-01", "agreementSection": "1", "100%Limit": 1000, "solvencyIIClass": "ZX", "aggregateLimit": 1000 }, "coverage": [ { "premium": 15000, "limitOccurrence": 100, "100%Limit": 500000, "limitAggregate": 100, "ratedPremium(100%)": 15000 }, { "premium": 15000, "limitOccurrence": 100, "100%Limit": 500000, "limitAggregate": 100, "ratedPremium(100%)": 15000 } ], "deduction": [ { "deduction": "BK", "deductionRate": 20 } ], "codeSplit": [ { "regulatoryCode": "E2", "codeSplitPc": 100, "gELR": 50 } ] }, { "agreement": { "gELR": 50, "agreement": "AGR0000159", "agreementActivity": "AGR0000159-22-01", "agreementSection": "1", "100%Limit": 1000, "solvencyIIClass": "ZX", "aggregateLimit": 1000 }, "coverage": [ { "premium": 15000, "limitOccurrence": 100, "100%Limit": 500000, "limitAggregate": 100, "ratedPremium(100%)": 15000 } ], "codeSplit": [ { "regulatoryCode": "E2", "codeSplitPc": 100, "gELR": 50 } ] }, { "agreement": { "gELR": 50, "agreement": "AGR0000159", "agreementActivity": "AGR0000159-22-01", "agreementSection": "1", "100%Limit": 1000, "solvencyIIClass": "ZX", "aggregateLimit": 1000 }, "coverage": [ { "premium": 15000, "limitOccurrence": 100, "100%Limit": 500000, "limitAggregate": 100, "ratedPremium(100%)": 15000 } ], "codeSplit": [ { "regulatoryCode": "E2", "codeSplitPc": 100, "gELR": 50 } ] }, { "agreement": { "gELR": 50, "agreement": "AGR0000159", "agreementActivity": "AGR0000159-22-01", "agreementSection": "1", "100%Limit": 1000, "solvencyIIClass": "ZX", "aggregateLimit": 1000 }, "coverage": [ { "premium": 15000, "limitOccurrence": 100, "100%Limit": 500000, "limitAggregate": 100, "ratedPremium(100%)": 15000 } ], "codeSplit": [ { "regulatoryCode": "E2", "codeSplitPc": 100, "gELR": 50 } ] } ], "productTemplateSectionToAdd": "Directors and Officers", "bindProbability": "100%", "majorPeril": "Cyber Property", "uMR": "" }
 
application/json

Bind Submission

post
https://trident-api.connecttrident.com/submission/bind

Query Parameters

policyKeystring

Policy key for the submission to bind

Example:POL123456

policyActivityKeystring

Policy activity key for the submission to bind

Example:ACT789012

Body

application/json

Complete cyber submission request

BindQuoteCyberRequest

prebindSanctionCheckCompletebooleanrequired
territorystringrequired

territory code for the bind, e.g., ‘USA’, ‘EU’, ‘APAC’

majorPerilstringrequired

majorPeril code for the bind, e.g., ‘CYB’

mosaicOccupationstringrequired

mosaicOccupation code for the bind, e.g., ‘MOS001’

obligorstringrequired

obligor description for the bind, e.g., ‘Test Obligor’

Response

200 application/json

OK

object
post/submission/bind

Body

{ "prebindSanctionCheckComplete": true, "mosaicOccupation": "MOS001", "obligor": "Test Obligor", "majorPeril": "Cyber Property", "territory": "USA" }
 
200 application/json