Trident APIs

InsuredEnrichment

object

Bind-time insured enrichment fields (Step 4 only). Carries the additional insured attributes entered in XFI at bind — occupation, LOB-specific details, issuance address, policyholder type, and tax identification numbers. The core contact fields (companyName, domicile, mailing address) are already on the draft from Step 1 and do not need to be re-sent.

occupationSourceobjectrequired

Required. Occupation source — id only. Identifies the source system used for the occupation lookup (e.g. D&B). Source: XFI Contact (General) > Insured section.

* Additional properties are NOT allowed.
Show Child Parameters
occupationstringrequired

Required. Insured occupation description. Enter as sourced from D&B lookup or submission documentation (e.g. ‘Software Development’).

Example:Software Development

assetsUnderManagementstring

Required for FI LOB. Assets under management (string). Source: booking sheet or Tyche rater.

Example:500000000

assetSizestring

Required for FI LOB. Asset size (string). Source: booking sheet or Tyche rater.

Example:1000000000

webSitestring

Required for CY LOB. Insured website URL. Source: submission documentation or insured.

Example:https://www.veritascap.com

policyholderTypeobject

Policyholder type — id only. Source: fiscal/regulatory section of the slip.

* Additional properties are NOT allowed.
Show Child Parameters
issuanceAddressSameAsInsuredboolean

Set true to copy the insured address to the issuance address (Direct business). Set false and supply issuanceTo, issuanceAddress1, issuanceCity, etc. for Assumed / RI business.

Example:true

issuanceTostring

Reassured name on the issuance address — populate when issuanceAddressSameAsInsured is false.

Example:Munich Re

issuanceAddress1string

Issuance address line 1 — populate when issuanceAddressSameAsInsured is false.

Example:Koeniginstrasse 107

issuanceAddress2string

Issuance address line 2.

Example:PO Box 123

issuanceCitystring

Issuance address city.

Example:Munich

issuanceStateobject

Issuance address state — id only.

* Additional properties are NOT allowed.
Show Child Parameters
issuancePostCodestring

Issuance address post code.

Example:80802

issuanceDateReviewedstring(date)

Date the issuance address was reviewed.

Example:2026-07-01

mailingAddress2string

Second mailing address line.

Example:Suite 400

mailingAddressCountryobjectrequired

Required. Insured mailing address country — code only. Also mandatory for BDX reporting when insured has exposure in Spain, Portugal, Italy, or Canada.

* Additional properties are NOT allowed.
Show Child Parameters
mailingAddressStateobject

Required for US and Canada insureds. Mailing address state — id only.

* Additional properties are NOT allowed.
Show Child Parameters
mailingAddressPostCodestring

Insured mailing address post code / zip. Supply for US insureds and any other country where postal codes apply.

Example:54302

contactCodesobject

Tax identification numbers and regulatory codes for the insured. Supply only the TINs required by the insured’s domicile or risk country: fein (US), taxIdSpain, taxIdItaly, taxIdPortugal, canadianBusinessNumber.

Show Child Parameters
Example

ContactCodes

object

Tax identification numbers and regulatory codes for the insured — maps to XFI Contact > Codes section. All fields optional; supply only those required by the insured’s domicile or risk country.

feinstring

Federal Employer Identification Number (US).

Example:12-3456789

taxIdSpainstring

Spanish Tax Identification Number (NIF/NIE). Mandatory per Lloyd’s coverholder reporting standard when insured has Spain exposure.

Example:A12345678

taxIdItalystring

Italian Tax Identification Number (Codice Fiscale). Mandatory per Lloyd’s coverholder reporting standard when insured has Italy exposure.

Example:RSSMRA85T10A562S

taxIdPortugalstring

Portuguese Tax Identification Number (NIF). Mandatory per Lloyd’s coverholder reporting standard when insured has Portugal exposure.

Example:123456789

canadianBusinessNumberstring

Canadian Business Number (BN). Required for any Canadian insured or where risk is located in Canada. Does NOT apply when a Canadian broker is involved in the placement.

Example:123456789RT0001

Example

SurplusBroker

object

Surplus and sub-producer details for US-origin risks. Required when risk premium originates from the United States. Note: surplusLinesBroker is the surplus lines broker entity — distinct from the main insurance producer in SubmissionRequest.producer.

typeofAdmittedobject

Required (US-origin risks). US admitted classification — id only. Set to ‘Surplus’ for US surplus lines business. Source: fiscal/regulatory section of the slip.

* Additional properties are NOT allowed.
Show Child Parameters
surplusLinesBrokerobject

Required (US-origin risks). Surplus lines broker entity — id only. Search and match in XFI by broker name and address. If not found, request addition via the WNS leads process.

* Additional properties are NOT allowed.
Show Child Parameters
brokerLicensestring

Required (US-origin risks). Surplus lines broker licence number as stated on the slip. Query the broker directly if the licence number is missing.

Example:SL-CA-12345

slaNumberstring

Required when producerHomeState is New Jersey. NJ SLA Transaction Number. Format: {5-character SLA}-{YY}-{5-digit sequence} (e.g. ‘AB123-26-00001’).

Example:AB123-26-00001

producerHomeStateobject

Required (US-origin risks). State of filing (producer home state) — id only. Source: fiscal/regulatory section of the slip.

* Additional properties are NOT allowed.
Show Child Parameters
Example

AdditionalContact

object

An additional contact on the policy — CY LOB only.

roleobject

Contact role — id only.

* Additional properties are NOT allowed.
Show Child Parameters
contactobject

Contact reference — id only.

* Additional properties are NOT allowed.
Show Child Parameters
Example

Line

object

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.

underWriterobject

Submission. Required. Underwriter with authority to write the risk — id only. Provided per agency line. Trident copies this to the syndicate lines. Source: underwriter’s email/document.

* Additional properties are NOT allowed.
Show Child Parameters
typeOfBillingobject

Submission. Required. Type of billing — id only (default ‘Producer billed’). Trident copies to syndicate lines.

* Additional properties are NOT allowed.
Show Child Parameters
divisionobject

Submission. Required. Agency division — id only. Identifies the Mosaic entity binding this agency line (e.g. MSSL, MAIS; MAE = 7). Trident matches this against XFI Get All Lines to locate the agency line. Do NOT confuse with the top-level shell division.

* Additional properties are NOT allowed.
Show Child Parameters
writtenLinenumber(double)

Submission. Required. Written line percentage for this agency line (a.k.a. Agency Share %). Default 100 if not supplied. XFI auto-generates actualWrittenLine% from this. Trident copies to syndicate lines.

Example:100

producingCompanyobject

Submission. Conditional. Producing company — id only. Required when division = Mosaic Asta Europe (7); set to the relevant Non-EEA agency division (e.g. MSSL, MAIS).

* Additional properties are NOT allowed.
Show Child Parameters
sBFClassobject

Submission. SBF (Syndicate Business Forecast) class — id only (default Cyber). Provided per agency line; Trident copies to syndicate lines.

* Additional properties are NOT allowed.
Show Child Parameters
producingUnderwriterobject

Quote. Producing underwriter for this line — id only. The underwriter who produced this line. Confirmed at bind by the stamp on the slip.

* Additional properties are NOT allowed.
Show Child Parameters
ourRoleobject

Quote. Required. Our role in the placement — id only. MAIS and Canada entities default to ‘Sole Lead’.

* Additional properties are NOT allowed.
Show Child Parameters
signedLinePercentagenumber(double)

Quote. Required. Signed line percentage for this line. At quote, signed line equals written line; at bind it may be reduced (never exceeds written line). Note: for PV MAIS, Excess Casualty and Energy Liability, Syndicate 2610/5431 written & signed line are always 0%.

Example:100

lloydsPlatformobject

Quote. Lloyd’s platform — id only. Set for MAE (Lloyd’s Brussels) and Singapore (Lloyd’s Asia) divisions; otherwise leave blank. Provided per agency line.

* Additional properties are NOT allowed.
Show Child Parameters
bureauLeadobject

Quote. Bureau lead — id only. E.g. ‘PV Portal’ for PV MAIS; otherwise usually blank. Provided per agency line (moved from UW Defaults).

* Additional properties are NOT allowed.
Show Child Parameters
isThirdPartyCapacityDeployedboolean

Quote. Third-party capacity deployed — default true (most Mosaic risks are routed through SCM). Agency/MAE lines: always checked. Trident leaves this BLANK on syndicate lines (1609/2610/5399/5431).

Example:true

syndicateCapitalManagementobject

Quote. Conditional. SCM broker partner — id only. Required when isThirdPartyCapacityDeployed = true. Default ‘Acrisure’ at quote; updated at bind per the SCM tracker. Trident leaves this BLANK on syndicate lines.

* Additional properties are NOT allowed.
Show Child Parameters
leadingInsurerobject

Quote/Bind. Conditional. Leading insurer — id only. Required when the slip leader is non-Lloyd’s. Source: Subscription Agreement section of the slip.

* Additional properties are NOT allowed.
Show Child Parameters
brokerOrderPercentnumber(double)

FON. Broker order percentage. Auto-calculated when written line and order are entered; updated on bind.

Example:50

signedOrderPercentnumber(double)

FON. Signed order percentage (SOP: always 100%). Kept in the API for simplicity.

Example:100

claimsAgreementPartyboolean

Bind. Required. Whether Mosaic is the claims agreement party. Set true when Mosaic is sole/bureau lead or a claims agreement party. Set false otherwise. 2610/5431 lines are always false. Source: Claims Agreement Party section of the slip.

Example:true

defenseCostsCoveredboolean

Bind. Defense costs covered — default true for all LOBs except PL. Required for PL LOB (processed per the Defense Cost section). Provided per agency line.

leaderPercentnumber(double)

Bind. Required when the slip leader is non-Lloyd’s. Leader percentage. Source: Subscription Agreement section of the slip.

Example:25

leaderReferencestring

Bind. Leader reference. Populated when the slip leader is non-Lloyd’s. Source: Subscription Agreement section of the slip.

Example:LDR-2026-001

actualDateWrittenstring(date)

Bind. Required. Date the underwriter agreed/stamped the slip. Found with the stamp on the slip.

Example:2026-07-01

dateSignedstring(date)

Bind. Required. Signed date as stamped on the slip. Trident copies to syndicate lines.

Example:2026-07-01

policyLineReferenceOverridestring

Bind. Required. Base syndicate policy line reference (a.k.a. Reference Override) supplied by the front end. Trident derives the agency and parallel-syndicate references from this: agency lines increment the trailing alphabetic character (…AA → AB); parallel syndicate lines (2610/5431) replace the trailing character with an incrementing numeral (…AA → A1).

Example:PWT3876925AA

Example