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) — code only. Source: fiscal/regulatory section of the slip.

* Additional properties are NOT allowed.
Show Child Parameters
Example

FonActivity

object

FON (Final Offer & Negotiation) attributes at the policy activity level. CY LOB only. Carries FON date, jurisdiction details, and regulatory location for the insured risk.

fonDatestring(date)required

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

jurisdictionCountryobjectrequired

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.

* Additional properties are NOT allowed.
Show Child Parameters
jurisdictionStateobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
riskRegulatoryLocationobjectrequired

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.

* Additional properties are NOT allowed.
Show Child Parameters
Example

ContactLiaisonSubmission

object

Broker contact liaison recorded under the producer for this submission. The platform resolves this block one of three ways:

  1. Update by key — supply contactliaisonid.id (an existing liaison key). That liaison is updated in place with the email, phoneNo, and mobilePhone values provided; the platform targets it directly without searching by name. firstName + lastName must also be supplied.
  2. Update by name match — omit contactliaisonid. When firstName + lastName match an existing liaison under the producer, that liaison is updated in place.
  3. Create — omit contactliaisonid and supply a firstName + lastName that do not match any existing liaison; a new liaison is created.

firstName and lastName are required in all three cases.

contactliaisonidobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
firstNamestringrequired

Required when creating a new contact (Mode B). First name of the broker contact person.

Example:John

lastNamestringrequired

Required when creating a new contact (Mode B). Last name of the broker contact person.

Example:Smith

emailstring(email)

Required when creating a new contact (Mode B). Email address of the liaison.

Example:Yes@example.com

phoneNostring

Required when creating a new contact (Mode B). Office/landline phone number of the liaison.

Example:9000000000

mobilePhonestring

Optional. Mobile / cell phone number of the liaison.

Example:899 898 09

faxNostring

Optional. Fax number of the liaison.

Example:45

stateobject

Optional. State where the liaison is located. Always send as code, e.g. { “code”: “UT” }.

Example:{"code":"UT"}

Show Child Parameters
cityobject

Optional. City where the liaison is located. Always send as description, e.g. { “description”: “Green Bay” }.

Example:{"description":"Green Bay"}

Show Child Parameters
regionobject

Optional. Region of the liaison. Always send as description, e.g. { “description”: “GBR” }.

Example:{"description":"GBR"}

Show Child Parameters
Example

SectionAgreement

object

Agreement reference for a quote section.

agreementstringrequired

Required. Agreement code (e.g. ‘AGR0000159’). The Mosaic binding authority agreement under which this section is written.

Example:AGR0000159

agreementActivitystringrequired

Required. Agreement activity code (e.g. ‘AGR0000159-22-01’). The specific year/version of the agreement activity.

Example:AGR0000159-22-01

agreementSectionstringrequired

Required. Agreement section identifier (e.g. ‘1’). Identifies the section within the agreement activity.

Example:1

Example

SectionCoverage

object

Coverage line within a quote section.

codestring

Coverage type code (e.g. SPL = Cyber Liability, BRC = Breach Response Cost). Identifies which coverage this line represents within the section.

Example:SPL

limitCurrencyobjectrequired

Required. Limit currency — code only. The currency in which the coverage limits are denominated, as stated in the quote documentation.

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

Required. Per-occurrence limit for this coverage (numeric, 100% basis). Source: quote documentation.

Example:500000

limitAggregatenumber(double)required

Required. Aggregate limit for this coverage (numeric, 100% basis). Source: quote documentation.

Example:500000

premiumnumber(double)required

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

premiumSplit%number(double)

Premium split percentage for this coverage line (numeric). Represents this coverage’s share of the total section premium.

Example:50

premiumCurrencyobjectrequired

Required. Premium currency — code only. The currency in which the premium is denominated, as stated in the quote documentation.

* Additional properties are NOT allowed.
Show Child Parameters
settlementCcyobjectrequired

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.

* Additional properties are NOT allowed.
Show Child Parameters
premiumBasisobjectrequired

Required. Premium basis — id only (e.g. Flat, M&D). Source: Premium Payment Terms section of the declaration slip.

* Additional properties are NOT allowed.
Show Child Parameters
typeofClaimBasisobjectrequired

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).

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

Optional. Waiting period amount for this coverage (numeric).

Example:25000

waitingPeriodMeasurementobject

Optional. Waiting period measurement unit — id only.

* Additional properties are NOT allowed.
Show Child Parameters
waitingPeriodTimenumber

Optional. Waiting period duration expressed in the selected measurement unit (numeric).

Example:12

Example