Complete Submission (Synchronous)
Creates a complete policy submission in a single call. Supports all lines of business.
This endpoint accepts all required fields (insured, producer, policy, underwriting data, etc.) in one request body.
Required fields
insured, producer, policy (effectiveDate, expiryDate, currency, product, territory), directAssumed, typeOfBilling, division, writtenLine, sectionIdentifier, referenceType, typeOfPlacementBespoke, underWriter, mosaicOccupation, revTurnover.
Conditional fields
referenceType — required when the submission’s producing entity (derived from division) is MSSL or MEEA.
producingCompany — required when division is Mosaic Asta Europe.
Optional fields
producingUnderwriter, lloydsIndustrialSector, sBFClass, policyDescription, class, marketSource, umr.
Derived server-side (not part of the contract)
office, mop, and typeOfPlacementBespoke derivations are handled server-side.
Response timing
For calls with large payloads such as this one, while XFI may respond in less than 2 minutes, the official SLA is 25 mins. Therefore, it is advisable to use the asynchronous call for Complete Submission instead of this synchronous call.
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
Policy creation payload. Supports all lines of business. Required: insured, producer, policy, directAssumed, typeOfBilling, division, writtenLine, sectionIdentifier, referenceType, typeOfPlacementBespoke, underWriter, mosaicOccupation, revTurnover.
FullRequest
Combines Shell (Step 1) and Full (Step 2) submission data.
Required: underWriter (id), revTurnover.
Shell fields (insured, producer, policy, directAssumed, typeOfBilling, division, writtenLine, sectionIdentifier, referenceType, typeOfPlacementBespoke, class) are required on first submission and optional on subsequent re-submissions (already on the draft).
Optional fields: producingUnderwriter (id), producingCompany (id), lloydsIndustrialSector (id), marketSource (id).
Per-line fields (ourRole, signedLinePercentage) are set via lines[] in quoteRequest.
Required. Underwriter who submitted the risk request — id only. Must be the underwriter with authority to write the business. Source: underwriter’s email or document.
Show Child Parameters
Required. Mosaic occupation — id only. Required for all LOBs. Source: insured occupation lookup.
Show Child Parameters
Conditional. Producing company — id only. Required when division is Mosaic Asta Europe (MAE).
Show Child Parameters
Conditional. Lloyd’s Industrial Sector override — id only. Required for all LOBs. When supplied, takes precedence over the server’s automatic derivation (UC8). Leave blank to allow automatic derivation.
Show Child Parameters
Required. Insured’s annual revenue or turnover (numeric). Required for CY, FI, PL and Casualty LOBs. Source: booking sheet or Tyche rater. Update if a more accurate figure is available at quote stage.
>= 0
Example:0
Required. Insured details — use insureContacts.id for an existing contact, or supply companyName + domicile fields for a new insured.
Show Child Parameters
Required. Producer (broker) reference. Supply id (producer id only). Optionally include a contactliaison block to attach, create, or update the broker contact liaison recorded on the policy (see ContactLiaisonSubmission).
Show Child Parameters
Required. Policy node (dates, currency, product, territory).
Show Child Parameters
Required. Business type — id only (Direct or Assumed).
Show Child Parameters
Required. id only.
Show Child Parameters
Required. id only.
Show Child Parameters
Written line percentage (numeric, e.g. 100). Default to 100 if not specified by the underwriter. If provided, enter the value from the underwriter’s email or document. For Agency Share %, enter the agency percentage here. Can be updated at any stage.
>= 1
Example:100
Optional. Free-text policy description. Defaulted/derived server-side when omitted.
Example:Cyber primary 2026 renewal
Required. Section identifier — id only (1 = C&C, 2 = Non C&C).
Show Child Parameters
Required. Reference type — id only (1 = EEA, 2 = Non-EEA, 3 = Both).
Show Child Parameters
Optional. Risk class — code only (e.g. { "code": "CY" }).
Show Child Parameters
Required. Mosaic MOP / bespoke type of placement — id only.
Show Child Parameters
Optional. Producing underwriter — id only. The underwriter who produced this submission.
Show Child Parameters
Optional. Market source — id only.
Show Child Parameters
Response
application/json
Response
Policy created 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
Headers
Body
Decline Submission (Synchronous)
Declines a submission. Moves the policy to Submission Declined status.
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
Policy key
Policy activity key
ID of the reason for declining submission
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 declined successfully
Authentication
Query Parameters
Headers
Void Transaction (Synchronous)
Voids a policy. Eligibility: The policy can only be voided when its status is Submission In Clear or Quote In Preparation.
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
Policy key
Example:1089434
Policy activity key
Example:1144621
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 voided successfully
Authentication
Query Parameters
Headers
Lookups
Look up contacts and allowed field values used across the platform.
Contacts (Synchronous)
Returns XFI contacts filtered by the specified role code. Supports optional free-text filter on contact name/code and page-based pagination via the page/pageSize query parameters (internally translated to XFI’s _start/_num).
Response shape: the response returns total (XFI’s reported match count) and item (the array of matched contacts for this request). item entries are passed through from XFI’s summary object verbatim (not a fixed schema) so any new attribute XFI adds in future is available automatically without an API change; the properties listed below are the common ones.
Common role codes:
| Code | Role |
|---|---|
USR |
Internal User (Underwriters) |
ACC |
Account / Insured |
PRD |
Producer / Broker |
AGR |
Agreement Partner |
OBG |
Obligor |
REIND |
Reinsured |
SCM |
Syndicate Capital Management |
INS |
Insurer |
COV |
Coverholder |
DIV |
Division |
SYN |
Syndicate |
MBK |
Master Broker |
All supported codes: INS, ATT, ACC, PRD, TAX, OTH, CLM, REIN, BCT, USR, EW, IA, EA, CA, AGR, PI, BINS, DIV, SYN, TCC, SRV, COV, LF, AUD, EXUSR, FRC, BA, SA, SOS, OFFTEAM, OBG, LG, RGA, INV, FIN, TAD, ENV, ITA, INA, BEN, ADO, ACF, UWC, BUY, SEL, TGT, PTF, REIND, SCM, PEB, MBK
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
XFI role code to filter contacts by. See description for full list.
Allowed values:INSATTACCPRDTAXOTHCLMREINBCTUSREWIAEACAAGRPIBINSDIVSYNTCCSRVCOVLFAUDEXUSRFRCBASASOSOFFTEAMOBGLGRGAINVFINTADENVITAINABENADOACFUWCBUYSELTGTPTFREINDSCMPEBMBK
Example:USR
Optional partial match on contact name or code (e.g. “Enbridge Inc.”, “MSR”).
Example:Enbridge Inc.
Page number, 1-based. Defaults to 1.
Default:1
>= 1
Example:1
Number of results per page. Defaults to 25. Maximum 100.
Default:25
>= 1<= 100
Example:25
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
Contacts retrieved successfully. Only ‘Active’ and ‘Not Approved’ broker information is pulled from XFI in the Lookup contact by roles endpoint response.
ContactFuzzySearchResponse
Response returned by the /lookup/contacts endpoint. Wraps XFI’s _count/_links.item[].summary payload as total/item.
Total number of matching contacts reported by XFI (_count).
A single contact entry returned by the /lookup/contacts endpoint, passed through from XFI’s summary object verbatim. Backing Java type is Map<String, Object> — keys are not fixed/known in advance (XFI may return any of contactKey, contactReference, code, roleCode, mainrole, email, mailingAddress1, mailingAddress2, mailingAddressCity, country, or others), so no fixed property list is declared here.