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.

post
https://apinonprod.mosaicinsurance.com/submission/completeasync

Query Parameters

policyKeystring

Optional policy key.

Example:1090252

policyActivityKeystring

Optional policy activity key.

Example:1145497

Headers

X-Origination-Sourcestringrequired

Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.

Example:S01x

X-Audit-UserIdstringrequired

Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

Example:jsmith

Body

application/json

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.

underWriterobjectrequired

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.

* Additional properties are NOT allowed.
Show Child Parameters
mosaicOccupationobjectrequired

Required. Mosaic occupation — id only. Required for all LOBs. Source: insured occupation lookup.

* Additional properties are NOT allowed.
Show Child Parameters
producingCompanyobject

Conditional. Producing company — id only. Required when division is Mosaic Asta Europe (MAE).

* Additional properties are NOT allowed.
Show Child Parameters
lloydsIndustrialSectorobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
revTurnoverinteger(int32)required

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

insuredobjectrequired

Required. Insured details — use insureContacts.id for an existing contact, or supply companyName + domicile fields for a new insured.

Show Child Parameters
producerobjectrequired

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
policyobjectrequired

Required. Policy node (dates, currency, product, territory).

Show Child Parameters
directAssumedobjectrequired

Required. Business type — id only (Direct or Assumed).

* Additional properties are NOT allowed.
Show Child Parameters
typeOfBillingobjectrequired

Required. id only.

* Additional properties are NOT allowed.
Show Child Parameters
divisionobjectrequired

Required. id only.

* Additional properties are NOT allowed.
Show Child Parameters
writtenLineinteger(int32)required

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

policyDescriptionstring

Optional. Free-text policy description. Defaulted/derived server-side when omitted.

Example:Cyber primary 2026 renewal

sectionIdentifierobjectrequired

Required. Section identifier — id only (1 = C&C, 2 = Non C&C).

* Additional properties are NOT allowed.
Show Child Parameters
referenceTypeobjectrequired

Required. Reference type — id only (1 = EEA, 2 = Non-EEA, 3 = Both).

* Additional properties are NOT allowed.
Show Child Parameters
classobject

Optional. Risk class — code only (e.g. { "code": "CY" }).

* Additional properties are NOT allowed.
Show Child Parameters
typeOfPlacementBespokeobjectrequired

Required. Mosaic MOP / bespoke type of placement — id only.

* Additional properties are NOT allowed.
Show Child Parameters
producingUnderwriterobject

Optional. Producing underwriter — id only. The underwriter who produced this submission.

* Additional properties are NOT allowed.
Show Child Parameters
marketSourceobject

Optional. Market source — id only.

* Additional properties are NOT allowed.
Show Child Parameters

Response

202 application/json

Accepted for asynchronous FULL execution. No other stage will be started.

submissionIdstring(uuid)

Submission execution identifier.

policyNostring
policyKeystring
policyActivityKeystring
statusstring

Example:ACCEPTED

messagestring
post/submission/completeasync

Body

{ "insured": { "companyName": "Veritas Capital Test 2", "domicileCountry": { "code": "USA" }, "domicileState": { "code": "NJ" }, "mailingAddress1": "1123 Cedar Street", "mailingAddressCity": "Green Bay", "email": "noemail@example.com", "zipCode": "75039" }, "producer": { "id": "2000556" }, "policy": { "effectiveDate": "2026-01-01", "expiryDate": "2027-01-01", "currency": { "code": "USD" }, "product": { "id": "4" }, "territory": { "code": "GBR" } }, "directAssumed": { "id": "1" }, "typeOfBilling": { "id": "1" }, "division": { "id": "2" }, "writtenLine": 100, "sectionIdentifier": { "id": "1" }, "referenceType": { "id": "2" }, "class": { "code": "CY" }, "producingCompany": { "id": "2" }, "typeOfPlacementBespoke": { "id": "1" }, "underWriter": { "id": "2001685" }, "producingUnderwriter": { "id": "2001685" }, "mosaicOccupation": { "id": "792" }, "revTurnover": 50000, "lloydsIndustrialSector": { "id": "10" }, "sBFClass": { "id": "7" }, "policyDescription": "UAT Test" }
 
202 application/json

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.

post
https://apinonprod.mosaicinsurance.com/submission/complete

Headers

X-Origination-Sourcestringrequired

Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.

Example:S01x

X-Audit-UserIdstringrequired

Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

Example:jsmith

Body

application/json

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.

underWriterobjectrequired

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.

* Additional properties are NOT allowed.
Show Child Parameters
mosaicOccupationobjectrequired

Required. Mosaic occupation — id only. Required for all LOBs. Source: insured occupation lookup.

* Additional properties are NOT allowed.
Show Child Parameters
producingCompanyobject

Conditional. Producing company — id only. Required when division is Mosaic Asta Europe (MAE).

* Additional properties are NOT allowed.
Show Child Parameters
lloydsIndustrialSectorobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
revTurnoverinteger(int32)required

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

insuredobjectrequired

Required. Insured details — use insureContacts.id for an existing contact, or supply companyName + domicile fields for a new insured.

Show Child Parameters
producerobjectrequired

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
policyobjectrequired

Required. Policy node (dates, currency, product, territory).

Show Child Parameters
directAssumedobjectrequired

Required. Business type — id only (Direct or Assumed).

* Additional properties are NOT allowed.
Show Child Parameters
typeOfBillingobjectrequired

Required. id only.

* Additional properties are NOT allowed.
Show Child Parameters
divisionobjectrequired

Required. id only.

* Additional properties are NOT allowed.
Show Child Parameters
writtenLineinteger(int32)required

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

policyDescriptionstring

Optional. Free-text policy description. Defaulted/derived server-side when omitted.

Example:Cyber primary 2026 renewal

sectionIdentifierobjectrequired

Required. Section identifier — id only (1 = C&C, 2 = Non C&C).

* Additional properties are NOT allowed.
Show Child Parameters
referenceTypeobjectrequired

Required. Reference type — id only (1 = EEA, 2 = Non-EEA, 3 = Both).

* Additional properties are NOT allowed.
Show Child Parameters
classobject

Optional. Risk class — code only (e.g. { "code": "CY" }).

* Additional properties are NOT allowed.
Show Child Parameters
typeOfPlacementBespokeobjectrequired

Required. Mosaic MOP / bespoke type of placement — id only.

* Additional properties are NOT allowed.
Show Child Parameters
producingUnderwriterobject

Optional. Producing underwriter — id only. The underwriter who produced this submission.

* Additional properties are NOT allowed.
Show Child Parameters
marketSourceobject

Optional. Market source — id only.

* Additional properties are NOT allowed.
Show Child Parameters

Response

application/json

Policy created successfully.

CyberSubmissionResponse

Response object containing cyber submission details including policy information, status, and reference keys

policyStatusstringrequired

Current status of the policy

Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU

Example:Quote Preparation

policyNostringrequired

Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies

Match pattern:^[QP]\d{7}$

Example:Q0038456

referencestring | null

Business reference number for tracking purposes

Example:CYB-2026-001

policyKeystringrequired

Internal policy key identifier used for database references

Example:20894

policyActivityKeystring

Internal policy activity key identifier for tracking specific policy activities

Example:45632

policyActivityStatusstring

Status of the current policy activity

Allowed values:ActiveCompletedPendingCancelledQuote NTU

Example:Active

quoteNostring | null

Quote number assigned when the submission reaches quote stage.

Example:Q0021748

post/submission/complete

Body

{ "insured": { "companyName": "Veritas Capital Test 2", "domicileCountry": { "code": "USA" }, "domicileState": { "code": "NJ" }, "mailingAddress1": "1123 Cedar Street", "mailingAddressCity": "Green Bay", "email": "noemail@example.com", "zipCode": "75039" }, "producer": { "id": "2000556" }, "policy": { "effectiveDate": "2026-01-01", "expiryDate": "2027-01-01", "currency": { "code": "USD" }, "product": { "id": "4" }, "territory": { "code": "GBR" } }, "directAssumed": { "id": "1" }, "typeOfBilling": { "id": "1" }, "division": { "id": "2" }, "writtenLine": 100, "sectionIdentifier": { "id": "1" }, "referenceType": { "id": "2" }, "class": { "code": "CY" }, "producingCompany": { "id": "2" }, "typeOfPlacementBespoke": { "id": "1" }, "underWriter": { "id": "2001685" }, "producingUnderwriter": { "id": "2001685" }, "mosaicOccupation": { "id": "792" }, "revTurnover": 50000, "lloydsIndustrialSector": { "id": "10" }, "sBFClass": { "id": "7" }, "policyDescription": "UAT Test" }
 
application/json

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.

post
https://apinonprod.mosaicinsurance.com/submission/decline

Query Parameters

policyKeystringrequired

Policy key

policyActivityKeystringrequired

Policy activity key

declineReasonstring

Reason for declining submission

Headers

X-Origination-Sourcestringrequired

Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.

Example:S01x

X-Audit-UserIdstringrequired

Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

Example:jsmith

Response

application/json

Policy declined successfully

string
post/submission/decline
 
application/json

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.

post
https://apinonprod.mosaicinsurance.com/submission/additionalContacts

Query Parameters

policyIdstringrequired

XFI policy id (policyKey).

Example:1089712

policyActivityIdstringrequired

XFI policy activity id (policyActivityKey).

Example:1144905

Headers

X-Origination-Sourcestringrequired

Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.

Example:S01x

X-Audit-UserIdstringrequired

Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

Example:jsmith

Body

application/json

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

roleobjectrequired
Show Child Parameters
companyNamestring

Company name for a new contact.

domicileCountryobject
Show Child Parameters
domicileStateobject
Show Child Parameters
mailingAddress1string
mailingAddressCitystring
emailstring(email)
zipCodestring
additionalcontactidobject

Lookup an existing XFI contact instead of creating a new one.

Show Child Parameters

Response

application/json

Contacts attached successfully.

policyIdstringrequired
policyActivityIdstringrequired
attachedCountintegerrequired
contactsarray[object]required
Show Child Parameters
post/submission/additionalContacts

Body

[ { "role": { "id": "6" }, "additionalcontactid": { "id": "4044341" } }, { "role": { "id": "6" }, "companyName": "Veritas Capital UAT Test 11", "domicileCountry": { "code": "USA" }, "domicileState": { "code": "NY" }, "mailingAddress1": "1123 Cedar Street", "mailingAddressCity": "Green Bay", "email": "noemail@example.com", "zipCode": "75039" } ]
 
application/json