---
title: "SubmissionRequest"
url: "https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579/schemas/SubmissionRequest"
---

> Full API specification: https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579.md

# SubmissionRequest

Shell submission payload (internal/legacy schema). Reference fields are restricted per field: `producer`, `directAssumed`, `typeOfBilling`, `division`, `typeOfPlacementBespoke`, `policy.product`, and `insured.insureContacts` accept **`id` only**; `class`, `policy.currency`, `policy.territory` accept **`code` only**; `sectionIdentifier` accepts **`id` only** (1 = C&C, 2 = Non C&C) and `referenceType` accepts **`id` only** (1 = EEA, 2 = Non-EEA, 3 = Both).

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Trident APIs
  version: dev
servers:
  - url: https://apinonprod.mosaicinsurance.com
    description: Generated server url
components:
  schemas:
    SubmissionInsured:
      type: object
      description: >-
        Insured details for the shell submission.


        **Option A — Existing contact:** Set `insureContacts.id` to the XFI
        contact identifier. All other insured fields are ignored.


        **Option B — New insured:** Provide `companyName`, `domicileCountry`,
        `domicileState`, and any available mailing-address fields.
        `insureContacts` must be omitted.
      properties:
        companyName:
          type: string
          description: "**Required when creating a new insured** (i.e. `insureContacts` is
            not provided). Legal company name as stated in the submission
            documentation."
          x-conditional-required: Required when creating a new insured (insureContacts not provided).
          example: Veritas Capital
        domicileCountry:
          description: '**Required when creating a new insured.** Domicile country —
            **always send as `code`**, e.g. `{ "code": "USA" }`. Represents the
            country where the insured is legally domiciled.'
          example:
            code: USA
          properties:
            code:
              description: ISO country code or XFI country code.
              example: USA
              type: string
          required:
            - code
          type: object
          x-conditional-required: Required when creating a new insured (insureContacts not provided).
        domicileState:
          description: '**Required when creating a new insured** and the domicile country
            has state-level data. Domicile state — **always send as `code`**,
            e.g. `{ "code": "NY" }`.'
          example:
            code: NJ
          properties:
            code:
              description: State/province code.
              example: NY
              type: string
          required:
            - code
          type: object
          x-conditional-required: Required when creating a new insured (insureContacts not provided).
        mailingAddress1:
          type: string
          example: 123 Cedar Street
        mailingAddressCity:
          type: string
          example: Green Bay
        email:
          type: string
          format: email
          description: Optional if insureContacts is provided.
          example: underwriting@veritascap.com
        zipCode:
          type: string
          description: Post code / zip for the insured mailing address. **Required when
            creating a new insured** and the insured’s country uses postal
            codes.
          x-conditional-required: Required when creating a new insured and the country
            uses postal codes.
          example: "54304"
        obligor:
          $ref: "#/components/schemas/IdReference"
          description: Conditional — Political Risk only. Obligor contact reference — `id`
            only.
        insureContacts:
          $ref: "#/components/schemas/IdReference"
          description: 'Insured contact reference — `id` only (e.g. `{ "id": "2000887"
            }`). Use this to reference an existing insured in XFI. When
            supplied, all other insured fields (companyName, domicile, mailing
            address) are ignored.'
    IdReference:
      type: object
      description: Reference to a lookup-backed entity identified by `id` (the XFI
        lookup id, environment-specific).
      required:
        - id
      additionalProperties: false
      properties:
        id:
          type: string
          description: XFI lookup id — the canonical identifier (environment-specific).
          example: "260"
    SubmissionPolicy:
      type: object
      description: Policy node. effectiveDate, expiryDate, currency, product,
        territory are mandatory.
      required:
        - effectiveDate
        - expiryDate
        - currency
        - product
        - territory
      properties:
        effectiveDate:
          type: string
          format: date
          description: "**Required.** Policy effective date (ISO 8601). Source: policy
            terms section of the slip."
          example: 2024-01-01
        expiryDate:
          type: string
          format: date
          description: "**Required.** Policy expiry date (ISO 8601). Source: policy terms
            section of the slip."
          example: 2025-01-01
        currency:
          $ref: "#/components/schemas/CodeReference"
          description: "**Required.** Currency reference — `code` only (e.g. `USD`, `GBP`,
            `EUR`)."
        product:
          $ref: "#/components/schemas/IdReference"
          description: "**Required.** Product reference — `id` only."
        territory:
          $ref: "#/components/schemas/CodeReference"
          description: "**Required.** Territory reference — `code` only."
    SectionIdentifierRef:
      type: object
      description: Section identifier, identified by `id`. Ids are fixed and stable
        across all environments.
      required:
        - id
      additionalProperties: false
      properties:
        id:
          type: string
          enum:
            - "1"
            - "2"
          description: 1 = C&C, 2 = Non C&C.
          example: "1"
    ReferenceTypeRef:
      type: object
      description: Reference type, identified by `id`. Ids are fixed and stable across
        all environments.
      required:
        - id
      additionalProperties: false
      properties:
        id:
          type: string
          enum:
            - "1"
            - "2"
            - "3"
          description: 1 = EEA, 2 = Non-EEA, 3 = Both.
          example: "1"
    CodeReference:
      type: object
      description: Reference to a lookup-backed entity identified by `code` (the
        environment-stable business code).
      required:
        - code
      additionalProperties: false
      properties:
        code:
          type: string
    AdditionalContact:
      type: object
      description: An additional contact on the policy — CY LOB only.
      properties:
        role:
          $ref: "#/components/schemas/IdReference"
          description: Contact role — `id` only.
        contact:
          $ref: "#/components/schemas/IdReference"
          description: Contact reference — `id` only.
    SubmissionRequest:
      type: object
      description: "Shell submission payload (internal/legacy schema). Reference
        fields are restricted per field: `producer`, `directAssumed`,
        `typeOfBilling`, `division`, `typeOfPlacementBespoke`, `policy.product`,
        and `insured.insureContacts` accept **`id` only**; `class`,
        `policy.currency`, `policy.territory` accept **`code` only**;
        `sectionIdentifier` accepts **`id` only** (1 = C&C, 2 = Non C&C) and
        `referenceType` accepts **`id` only** (1 = EEA, 2 = Non-EEA, 3 = Both)."
      required:
        - insured
        - producer
        - policy
        - directAssumed
        - typeOfBilling
        - division
        - writtenLine
        - sectionIdentifier
        - referenceType
        - typeOfPlacementBespoke
      properties:
        insured:
          $ref: "#/components/schemas/SubmissionInsured"
          description: Required. Insured details; insureContacts.id identifies an existing
            insured contact, otherwise supply companyName + domicile
            country/state.
        producer:
          $ref: "#/components/schemas/IdReference"
          description: Required. Producer (broker) reference — `id` only.
        policy:
          $ref: "#/components/schemas/SubmissionPolicy"
          description: Required. Policy node (dates, currency, product, territory).
        directAssumed:
          $ref: "#/components/schemas/IdReference"
          description: Required. Business type — `id` only (Direct or Assumed).
        typeOfBilling:
          $ref: "#/components/schemas/IdReference"
          description: Required. `id` only.
        division:
          $ref: "#/components/schemas/IdReference"
          description: Required. `id` only.
        writtenLine:
          type: integer
          minimum: 1
          format: int32
          description: Required. Written line percentage (e.g. 100).
          example: 100
        policyDescription:
          type: string
          description: Optional. Free-text policy description. Defaulted/derived
            server-side when omitted.
          example: Cyber primary 2026 renewal
        sectionIdentifier:
          $ref: "#/components/schemas/SectionIdentifierRef"
          description: Required. Section identifier — `id` only (1 = C&C, 2 = Non C&C).
        referenceType:
          $ref: "#/components/schemas/ReferenceTypeRef"
          description: Required. Reference type — `id` only (1 = EEA, 2 = Non-EEA, 3 =
            Both).
        class:
          $ref: "#/components/schemas/CodeReference"
          description: 'Optional. Risk class — `code` only (e.g. `{ "code": "CYB001" }`).'
        typeOfPlacementBespoke:
          $ref: "#/components/schemas/IdReference"
          description: Required. Mosaic MOP / bespoke type of placement — `id` only.
        additionalContacts:
          type: array
          description: Optional. Additional contacts on the policy — CY LOB only. Supply
            role for each contact.
          items:
            $ref: "#/components/schemas/AdditionalContact"
```
