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
SectionCoverage
objectCoverage line within a quote section.
Coverage type code (e.g. SPL = Cyber Liability, BRC = Breach Response Cost). Identifies which coverage this line represents within the section.
Example:SPL
Required. Limit currency — code only. The currency in which the coverage limits are denominated, as stated in the quote documentation.
Show Child Parameters
Required. Per-occurrence limit for this coverage (numeric, 100% basis). Source: quote documentation.
Example:500000
Required. Aggregate limit for this coverage (numeric, 100% basis). Source: quote documentation.
Example:500000
Required. 100% gross premium for this coverage (numeric). If the underwriter provides a total premium without per-coverage splits, divide it equally across coverages or use the percentages supplied by the underwriter.
Example:15000
Premium split percentage for this coverage line (numeric). Represents this coverage’s share of the total section premium.
Example:50
Required. Premium currency — code only. The currency in which the premium is denominated, as stated in the quote documentation.
Show Child Parameters
Required. Settlement currency — code only. Options are restricted to the currencies available for the selected agreement. Default to match the premium/limit currency when not specified. Exception: Dubai division always settles in USD regardless of limit or premium currency.
Show Child Parameters
Required. Premium basis — id only (e.g. Flat, M&D). Source: Premium Payment Terms section of the declaration slip.
Show Child Parameters
Required. Claims basis — id only. LOB rules: PV = LOD; CY/PL = CMD; FI PI/D&O/EPLI = CM; FI BB/7T = LD; Excess Casualty = LOD (occurrence risk codes) or CM (claims-made risk codes).
Show Child Parameters
Optional. Waiting period amount for this coverage (numeric).
Example:25000
Optional. Waiting period measurement unit — id only.
Show Child Parameters
Optional. Waiting period duration expressed in the selected measurement unit (numeric).
Example:12