Complete Submission (Asynchronous)
Accepts the same request body and request-body examples as POST /submission/complete, but starts FULL execution asynchronously.
Optional query parameters
policyKey and policyActivityKey are optional. Example: /submission/completeasync?policyKey=1090252&policyActivityKey=1145497.
Response timing
For calls with large payloads such as this one, the SLA for the first step is less than 2 minutes. The first step is a synchronous call that returns the policy identifiers (policyNo, policyKey, and policyActivityKey). The second step of creation of the complete submission in XFI is asynchronous, for which the official SLA is 25 mins. Front-end clients can check status by using the Get Policy Status API (GET /policy/status) for the asynchronous operation. An accepted response does not mean processing has completed. Only FULL execution is started; no other stage will be started by this operation.
Query Parameters
Optional policy key.
Example:1090252
Optional policy activity key.
Example:1145497
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
202 application/json
Response
Accepted for asynchronous FULL execution. No other stage will be started.
Submission execution identifier.
Example:ACCEPTED
Authentication
Query Parameters
Headers
Body
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
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
Contacts
Attach additional contacts to an existing policy activity.
Attach Additional Contacts (Synchronous)
Attaches one or more contacts to an existing policy activity. Supported role ids are 6 (ACC), 79 (OBG), 92 (BUY), 93 (SEL), 96 (REIND), and 98 (PEB). For a new contact, provide companyName and any known address details. To attach an existing contact, provide additionalcontactid.id with the role. Existing and new contacts can be supplied together in the same request. The response includes the XFI contact key for each attached contact in request order.
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
XFI policy id (policyKey).
Example:1089712
XFI policy activity id (policyActivityKey).
Example:1144905
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
A non-empty array of additional contacts. Each entry must include a role. For new contacts, provide companyName; for existing contacts, provide additionalcontactid.id. Both forms can be mixed in one request.
>= 1 items
Show Child Parameters
Company name for a new contact.
Show Child Parameters
Show Child Parameters
Lookup an existing XFI contact instead of creating a new one.
Show Child Parameters
Response
application/json
Response
Contacts attached successfully.