InsuredEnrichment
objectBind-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.
Required. Occupation source — id only. Identifies the source system used for the occupation lookup (e.g. D&B). Source: XFI Contact (General) > Insured section.
Show Child Parameters
Required. Insured occupation — code only. Enter as sourced from D&B lookup or submission documentation.
Show Child Parameters
Required for FI LOB. Assets under management (string). Source: booking sheet or Tyche rater.
Example:500000000
Required for FI LOB. Asset size (string). Source: booking sheet or Tyche rater.
Example:1000000000
Required for CY LOB. Insured website URL. Source: submission documentation or insured.
Example:https://www.veritascap.com
Policyholder type — id only. Source: fiscal/regulatory section of the slip.
Show Child Parameters
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
Conditional. Reassured name on the issuance address — populate when issuanceAddressSameAsInsured is false.
Example:Munich Re
Conditional. Issuance address line 1 — populate when issuanceAddressSameAsInsured is false.
Example:Koeniginstrasse 107
Conditional. Issuance address line 2 — populate when issuanceAddressSameAsInsured is false.
Example:PO Box 123
Conditional. Issuance address city — populate when issuanceAddressSameAsInsured is false.
Example:Munich
Conditional. Issuance address state — id only. Populate when issuanceAddressSameAsInsured is false.
Show Child Parameters
Conditional. Issuance address post code — populate when issuanceAddressSameAsInsured is false.
Example:80802
Conditional. Date the issuance address was reviewed — populate when issuanceAddressSameAsInsured is false.
Example:2026-07-01
Second mailing address line.
Example:Suite 400
Required. Insured mailing address country — code only. Also mandatory for BDX reporting when insured has exposure in Spain, Portugal, Italy, or Canada.
Show Child Parameters
Required for US and Canada insureds. Mailing address state — code only.
Show Child Parameters
Insured mailing address post code / zip. Supply for US insureds and any other country where postal codes apply.
Example:54302
Federal Employer Identification Number (US).
<= 10 characters
Example:12-3456789
Spanish Tax Identification Number (NIF/NIE). Mandatory per Lloyd’s coverholder reporting standard when insured has Spain exposure.
<= 9 characters
Example:A12345678
Italian Tax Identification Number (Codice Fiscale). Mandatory per Lloyd’s coverholder reporting standard when insured has Italy exposure.
<= 16 characters
Example:RSSMRA85T10A562S
Portuguese Tax Identification Number (NIF). Mandatory per Lloyd’s coverholder reporting standard when insured has Portugal exposure.
<= 9 characters
Example:123456789
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.
<= 9 characters
Example:123456789RT0001
SurplusBroker
objectSurplus 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.
Required (US-origin risks). US admitted classification — id only. Set to ‘Surplus’ for US surplus lines business. Source: fiscal/regulatory section of the slip.
Show Child Parameters
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.
Show Child Parameters
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
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
Required (US-origin risks). State of filing (producer home state) — code only. Source: fiscal/regulatory section of the slip.
Show Child Parameters
FonActivity
objectFON (Final Offer & Negotiation) attributes at the policy activity level. CY LOB only. Carries FON date, jurisdiction details, and regulatory location for the insured risk.
Required for FON stage. The date the Final Offer & Negotiation was completed (ISO 8601 date, e.g. ‘2026-07-01’). Provided by the front-end system.
Example:2026-01-15
Required. Jurisdiction country — code only. The country where the insured risk is located. Found in the Fiscal & Regulatory section of the slip. This is NOT the same as the territory field.
Show Child Parameters
Required for US risks. Jurisdiction state — code only. The state where the US-domiciled insured risk is located. Provided by the front-end for US-origin submissions.
Show Child Parameters
Required. Regulatory risk location — code only. Where the regulator deems the risk to be situated, as stated in the Fiscal & Regulatory section of the slip. This is NOT the territory; the two fields serve different regulatory purposes.
Show Child Parameters
ContactLiaisonSubmission
objectBroker contact liaison recorded under the producer for this submission. The platform resolves this block one of three ways:
- Update by key — supply
contactliaisonid.id(an existing liaison key). That liaison is updated in place with theemail,phoneNo, andmobilePhonevalues provided; the platform targets it directly without searching by name.firstName+lastNamemust also be supplied. - Update by name match — omit
contactliaisonid. WhenfirstName+lastNamematch an existing liaison under the producer, that liaison is updated in place. - Create — omit
contactliaisonidand supply afirstName+lastNamethat do not match any existing liaison; a new liaison is created.
firstName and lastName are required in all three cases.
Optional. Existing contact liaison key (id only). When supplied, the platform attaches that liaison and all individual fields become optional. Omit to create or update by name match.
Show Child Parameters
Required when creating a new contact (Mode B). First name of the broker contact person.
Example:John
Required when creating a new contact (Mode B). Last name of the broker contact person.
Example:Smith
Required when creating a new contact (Mode B). Email address of the liaison.
Example:Yes@example.com
Required when creating a new contact (Mode B). Office/landline phone number of the liaison.
Example:9000000000
Optional. Mobile / cell phone number of the liaison.
Example:899 898 09
Optional. Fax number of the liaison.
Example:45
Optional. State where the liaison is located. Always send as code, e.g. { “code”: “UT” }.
Example:{"code":"UT"}
Show Child Parameters
Optional. City where the liaison is located. Always send as description, e.g. { “description”: “Green Bay” }.
Example:{"description":"Green Bay"}
Show Child Parameters
Optional. Region of the liaison. Always send as description, e.g. { “description”: “GBR” }.
Example:{"description":"GBR"}
Show Child Parameters
SectionAgreement
objectAgreement reference for a quote section.
Required. Agreement code (e.g. ‘AGR0000159’). The Mosaic binding authority agreement under which this section is written.
Example:AGR0000159
Required. Agreement activity code (e.g. ‘AGR0000159-22-01’). The specific year/version of the agreement activity.
Example:AGR0000159-22-01
Required. Agreement section identifier (e.g. ‘1’). Identifies the section within the agreement activity.
Example:1