Attach Additional Contacts (Synchronous)
Attaches one or more contacts to an existing policy activity. Supported role ids are 6 (ACC), 79 (OBG), 92 (BUY), 93 (SEL), 96 (REIND), and 98 (PEB). For a new contact, provide companyName and any known address details. To attach an existing contact, provide additionalcontactid.id with the role. Existing and new contacts can be supplied together in the same request. The response includes the XFI contact key for each attached contact in request order.
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
XFI policy id (policyKey).
Example:1089712
XFI policy activity id (policyActivityKey).
Example:1144905
Headers
Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
Example:S01x
Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.
Example:jsmith
Body
application/json
Body
A non-empty array of additional contacts. Each entry must include a role. For new contacts, provide companyName; for existing contacts, provide additionalcontactid.id. Both forms can be mixed in one request.
>= 1 items
Show Child Parameters
Company name for a new contact.
Show Child Parameters
Show Child Parameters
Lookup an existing XFI contact instead of creating a new one.
Show Child Parameters
Response
application/json
Response
Contacts attached successfully.
Show Child Parameters
Authentication
Query Parameters
Headers
Body
Quote
Create quotes and manage quote outcomes (decline, not-taken-up).
Create Quote
Adds quote (pricing and section) data to an existing policy activity — Step 2 of the submission lifecycle.
Pass the policyKey and policyActivityKey returned by POST /policies/submission/full as query parameters.
Required fields
sections array (at least one section with a valid agreement).
Lookup objects
All id-based reference fields accept id only (e.g. summaryCurrency, solvencyIIClass). Currency fields (currency, limitCurrency, premiumCurrency, settlementCcy) accept code only.
Response timing
The call typically completes within 20-40 seconds.
Query Parameters
policyKey returned by POST /policies/submission/full
Example:21748
policyActivityKey returned by POST /policies/submission/full
Example:33159
Headers
Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
Example:S01x
Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.
Example:jsmith
Body
application/json
Body
Quote submission payload. Required: sections array. Reference fields use IdReference (id only) except currency fields which use CodeReference (code only).
QuoteRequest
Request body for POST /policies/quote — Step 3 of the submission lifecycle.
Required. Summary (reporting) currency — code only (e.g. { "code": "USD" }).
Show Child Parameters
Required. Type of Cyber clause status — id only. Enter Cyber clause details per the quote document. Leave blank if not available at quote stage.
Show Child Parameters
Required. US classification — id only. Source: fiscal and regulatory section of the slip. Select ‘Regulated’ or ‘Non-Regulated’ when risk originates from the United States. Select ‘Non-Regulated’ when the risk does not originate from the United States. Leave blank if details are not yet available at quote stage (do not query).
Show Child Parameters
Unique Market Reference. Required. Source: risk details section of the UK slip. Leave blank if not yet available.
Example:B1234CYB2026001
Number of employees. Required for CY, FI and PL LOBs. Source: submission documentation or rater.
Example:250
Number of Personally Identifiable Information (PII) records held by the insured. Required for CY LOB. Source: submission documentation.
Example:100000
This is section description as configured in XFI. Required to create section in XFI. Non-business field managed by orchestration layer.
Example:Directors and Officers
Bind probability expressed as a percentage string (e.g. ‘100%’). Indicates the likelihood the risk will proceed to bind. Supplied by the underwriter or front-end.
Example:100%
Major peril description (e.g. ‘Cyber Property’). Server-derived from the risk’s class; supply if known, otherwise leave blank for automatic derivation.
Example:Cyber Property
A single section within a quote submission. The front end sends at most two section objects: one for the main Agency policy (MSSL/MAIS etc.), and one for the Mosaic Asta Europe (MAE) policy when the risk has an EEA component. Each section carries a division.id that identifies which agency line it belongs to. Trident uses this to determine which syndicate lines (1609/2610 for the agency section; 5399/5431 for the MAE section).
Show Child Parameters
A single agency policy line within a quote submission. Supply one element per underwriting agency line (one for the main Agency line; an additional one for the Mosaic Asta Europe agency line when the risk has an EEA component).
Front end supplies agency-line data only. Trident retrieves all XFI-created lines (agency + syndicate) via Get All Lines, identifies each by Division ID (Agency = front-end division.id; MAE = 7; 1609 = 3; 2610 = 12; 5399 = 6; 5431 = 13), and propagates most agency-line values to the syndicate lines (“Same as Agency Line”). Derived-only fields (originatingDivision, originatingOffice, global-risk cross-reference, inclusive-line) are computed by Trident and are not part of this payload.
Fields are grouped by stage: Submission → Quote → FON → Bind.
Show Child Parameters
Response
application/json
Response
Quote created or updated successfully.
CyberSubmissionResponse
Response object containing cyber submission details including policy information, status, and reference keys
Current status of the policy
Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU
Example:Quote Preparation
Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies
Match pattern:^[QP]\d{7}$
Example:Q0038456
Business reference number for tracking purposes
Example:CYB-2026-001
Internal policy key identifier used for database references
Example:20894
Internal policy activity key identifier for tracking specific policy activities
Example:45632
Status of the current policy activity
Allowed values:ActiveCompletedPendingCancelledQuote NTU
Example:Active
Quote number assigned when the submission reaches quote stage.
Example:Q0021748
Authentication
Query Parameters
Headers
Body
NTU Quote
Marks a quoted policy as Not Taken Up (NTU). Moves the policy from Quote to Quote NTU status, indicating the insured or broker chose not to proceed with the quoted terms.
Query Parameters
Unique identifier of the policy to be marked as NTU
Example:20793
Unique identifier of the policy activity associated with the quote
Example:45632
Optional reason explaining why the quote was not taken up
Example:Insured found a more competitive quote elsewhere
Headers
Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
Example:S01x
Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.
Example:jsmith
Response
application/json
Response
Policy successfully marked as Quote NTU
CyberSubmissionResponse
Response object containing cyber submission details including policy information, status, and reference keys
Current status of the policy
Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU
Example:Quote Preparation
Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies
Match pattern:^[QP]\d{7}$
Example:Q0038456
Business reference number for tracking purposes
Example:CYB-2026-001
Internal policy key identifier used for database references
Example:20894
Internal policy activity key identifier for tracking specific policy activities
Example:45632
Status of the current policy activity
Allowed values:ActiveCompletedPendingCancelledQuote NTU
Example:Active
Quote number assigned when the submission reaches quote stage.
Example:Q0021748
Authentication
Query Parameters
Headers
Policy
Create, retrieve, and search policies across the lifecycle.