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

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

# SubmissionInsured

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.

## 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:
    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"
    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.'
```