--- title: "BindRequest" url: "https://apipartners.mosaicinsurance.com/apis/trident-ap-is-beta/versions/018fd555-bac2-494f-872b-ac47b74f1e75/schemas/BindRequest" --- > Full API specification: https://apipartners.mosaicinsurance.com/apis/trident-ap-is-beta/versions/018fd555-bac2-494f-872b-ac47b74f1e75.md # BindRequest Policy-level bind attributes. Supply everything that does not belong to a specific section or line. **Key required fields:** `prebindSanctionCheckComplete`. `claimsAgreementParty` is a per-line attribute — supply it on each entry in `quoteRequest.lines[]`, not here (XFI only exposes it at the policy-line level). Section/line attributes (premiumBasis, typeofClaimBasis, instalmentbasis, leaderPercent, etc.) are carried in `quoteRequest` — not repeated here. The optional `fon` block carries FON-stage policy-activity attributes (CY LOB only). The optional `surplusBroker` block is required for US-origin risks. ## OpenAPI definition ```yaml openapi: 3.0.1 info: title: Trident APIs version: uat 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" 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 InsuredEnrichment: type: object description: Bind-time insured enrichment fields (Step 4 only). Carries the additional insured attributes entered in XFI at bind — occupation, LOB-specific details, issuance address, policyholder type, and tax identification numbers. The core contact fields (companyName, domicile, mailing address) are already on the draft from Step 1 and do not need to be re-sent. properties: occupationSource: $ref: "#/components/schemas/IdReference" description: "**Required.** Occupation source — `id` only. Identifies the source system used for the occupation lookup (e.g. D&B). Source: XFI Contact (General) > Insured section." occupation: $ref: "#/components/schemas/CodeReference" description: "**Required.** Insured occupation — `code` only. Enter as sourced from D&B lookup or submission documentation." assetsUnderManagement: type: string description: "**Required for FI LOB.** Assets under management (string). Source: booking sheet or Tyche rater." x-conditional-required: Required for FI LOB. example: "500000000" assetSize: type: string description: "**Required for FI LOB.** Asset size (string). Source: booking sheet or Tyche rater." x-conditional-required: Required for FI LOB. example: "1000000000" webSite: type: string description: "**Required for CY LOB.** Insured website URL. Source: submission documentation or insured." x-conditional-required: Required for CY LOB. example: https://www.veritascap.com policyholderType: $ref: "#/components/schemas/IdReference" description: "Policyholder type — `id` only. Source: fiscal/regulatory section of the slip." issuanceAddressSameAsInsured: type: boolean description: Set `true` to copy the insured address to the issuance address (Direct business). Set `false` and supply `issuanceTo`, `issuanceAddress1`, `issuanceCity`, etc. for Assumed / RI business. example: true issuanceTo: type: string description: "**Conditional.** Reassured name on the issuance address — populate when issuanceAddressSameAsInsured is false." example: Munich Re x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuanceAddress1: type: string description: "**Conditional.** Issuance address line 1 — populate when issuanceAddressSameAsInsured is false." example: Koeniginstrasse 107 x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuanceAddress2: type: string description: "**Conditional.** Issuance address line 2 — populate when issuanceAddressSameAsInsured is false." example: PO Box 123 x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuanceCity: type: string description: "**Conditional.** Issuance address city — populate when issuanceAddressSameAsInsured is false." example: Munich x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuanceState: $ref: "#/components/schemas/IdReference" description: "**Conditional.** Issuance address state — `id` only. Populate when issuanceAddressSameAsInsured is false." x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuancePostCode: type: string description: "**Conditional.** Issuance address post code — populate when issuanceAddressSameAsInsured is false." example: "80802" x-conditional-required: Required when issuanceAddressSameAsInsured is false. issuanceDateReviewed: type: string format: date description: "**Conditional.** Date the issuance address was reviewed — populate when issuanceAddressSameAsInsured is false." example: 2026-07-01 mailingAddress2: type: string description: Second mailing address line. example: Suite 400 mailingAddressCountry: $ref: "#/components/schemas/CodeReference" description: "**Required.** Insured mailing address country — `code` only. Also mandatory for BDX reporting when insured has exposure in Spain, Portugal, Italy, or Canada." mailingAddressState: $ref: "#/components/schemas/CodeReference" description: "**Required for US and Canada insureds.** Mailing address state — `code` only." x-conditional-required: Required for US and Canada insureds. mailingAddressPostCode: type: string description: Insured mailing address post code / zip. Supply for US insureds and any other country where postal codes apply. example: "54302" fein: type: string maxLength: 10 description: Federal Employer Identification Number (US). example: 12-3456789 taxIdSpain: type: string maxLength: 9 description: Spanish Tax Identification Number (NIF/NIE). Mandatory per Lloyd's coverholder reporting standard when insured has Spain exposure. example: A12345678 taxIdItaly: type: string maxLength: 16 description: Italian Tax Identification Number (Codice Fiscale). Mandatory per Lloyd's coverholder reporting standard when insured has Italy exposure. example: RSSMRA85T10A562S taxIdPortugal: type: string maxLength: 9 description: Portuguese Tax Identification Number (NIF). Mandatory per Lloyd's coverholder reporting standard when insured has Portugal exposure. example: "123456789" canadianBusinessNumber: type: string maxLength: 9 description: Canadian Business Number (BN). Required for any Canadian insured or where risk is located in Canada. Does NOT apply when a Canadian broker is involved in the placement. example: 123456789RT0001 required: - occupationSource - occupation - mailingAddressCountry SurplusBroker: type: object description: "Surplus and sub-producer details for US-origin risks. Required when risk premium originates from the United States. Note: `surplusLinesBroker` is the surplus lines broker entity — distinct from the main insurance producer in `SubmissionRequest.producer`." properties: typeOfAdmitted: $ref: "#/components/schemas/IdReference" description: "**Required (US-origin risks).** US admitted classification — `id` only. Set to 'Surplus' for US surplus lines business. Source: fiscal/regulatory section of the slip." x-conditional-required: Required when risk premium originates from the United States. surplusLinesBroker: $ref: "#/components/schemas/IdReference" description: "**Required (US-origin risks).** Surplus lines broker entity — `id` only. Search and match in XFI by broker name and address. If not found, request addition via the WNS leads process." x-conditional-required: Required when risk premium originates from the United States. brokerLicense: type: string description: "**Required (US-origin risks).** Surplus lines broker licence number as stated on the slip. Query the broker directly if the licence number is missing." example: SL-CA-12345 x-conditional-required: Required when risk premium originates from the United States. slaNumber: type: string description: "**Required when producerHomeState is New Jersey.** NJ SLA Transaction Number. Format: {5-character SLA}-{YY}-{5-digit sequence} (e.g. 'AB123-26-00001')." example: AB123-26-00001 x-conditional-required: Required when producerHomeState is New Jersey. producerHomeState: $ref: "#/components/schemas/CodeReference" description: "**Required (US-origin risks).** State of filing (producer home state) — `code` only. Source: fiscal/regulatory section of the slip." x-conditional-required: Required when risk premium originates from the United States. FonActivity: type: object description: FON (Final Offer & Negotiation) attributes at the policy activity level. CY LOB only. Carries FON date, jurisdiction details, and regulatory location for the insured risk. properties: fonDate: type: string format: date description: "**Required for FON stage.** The date the Final Offer & Negotiation was completed (ISO 8601 date, e.g. '2026-07-01'). Provided by the front-end system." example: 2026-01-15 jurisdictionCountry: $ref: "#/components/schemas/CodeReference" description: "**Required.** Jurisdiction country — `code` only. The country where the insured risk is located. Found in the Fiscal & Regulatory section of the slip. This is NOT the same as the `territory` field." jurisdictionState: $ref: "#/components/schemas/CodeReference" description: "**Required for US risks.** Jurisdiction state — `code` only. The state where the US-domiciled insured risk is located. Provided by the front-end for US-origin submissions." x-conditional-required: Required for US risks. riskRegulatoryLocation: $ref: "#/components/schemas/CodeReference" description: "**Required.** Regulatory risk location — `code` only. Where the regulator deems the risk to be situated, as stated in the Fiscal & Regulatory section of the slip. This is NOT the territory; the two fields serve different regulatory purposes." required: - fonDate - jurisdictionCountry - riskRegulatoryLocation BindRequest: type: object description: >- Policy-level bind attributes. Supply everything that does not belong to a specific section or line. **Key required fields:** `prebindSanctionCheckComplete`. `claimsAgreementParty` is a per-line attribute — supply it on each entry in `quoteRequest.lines[]`, not here (XFI only exposes it at the policy-line level). Section/line attributes (premiumBasis, typeofClaimBasis, instalmentbasis, leaderPercent, etc.) are carried in `quoteRequest` — not repeated here. The optional `fon` block carries FON-stage policy-activity attributes (CY LOB only). The optional `surplusBroker` block is required for US-origin risks. properties: prebindSanctionCheckComplete: type: boolean description: "**Required.** Confirms the pre-bind sanction check has been completed. Set to `true` before proceeding to bind. The submission will be rejected if this check has not been completed." example: true obligor: $ref: "#/components/schemas/IdReference" description: Obligor contact reference — `id` only. majorPeril: $ref: "#/components/schemas/IdReference" description: Major peril classification — `id` only. Server-derived from the risk’s class; supply here to override the derivation. territory: $ref: "#/components/schemas/CodeReference" description: 'Territory of the risk — `code` only (e.g. `{ "code": "USA" }`). Represents the location of the risk, not the regulatory location. When multiple locations exist, use the country with the highest concentration of risk properties. Raise a query to the underwriter if the territory is unclear.' typeofRIBasis: $ref: "#/components/schemas/IdReference" description: Type of RI basis — `id` only. **Required for Assumed (RI) business.** Leave blank for Direct business. x-conditional-required: Required for Assumed (RI) business. priorPending: type: string format: date description: Prior and pending date (ISO 8601 date string, e.g. '2025-01-01'). **Required for CY LOB.** Leave blank for all other LOBs. example: 2026-01-01 x-conditional-required: Required for CY LOB. priorActs: type: boolean description: Whether prior acts cover applies to this risk. example: true retroactiveDate: type: string format: date description: Retroactive date (ISO 8601 date string). Only applicable when `priorActs` is `true`; leave blank when `priorActs` is `false`. **Required for PV, CY and PL LOBs.** Leave blank for all other LOBs. example: 2026-01-01 x-conditional-required: Applicable only when priorActs is true. insured: $ref: "#/components/schemas/InsuredEnrichment" description: >- Bind-time insured enrichment — occupation, mailing/issuance address, policyholder type, and TINs. **Required fields:** `occupationSource` (id), `occupation`, `mailingAddressCountry` (code). **Conditional required:** `mailingAddressState` (US/Canada); `webSite` (CY LOB); `assetsUnderManagement` + `assetSize` (FI LOB); `taxIdSpain` / `taxIdPortugal` / `taxIdItaly` / `canadianBusinessNumber` (where insured has exposure in those countries). surplusBroker: $ref: "#/components/schemas/SurplusBroker" description: >- Surplus lines and sub-producer details. **Required when risk premium originates from the United States.** **Required fields:** `typeOfAdmitted` (id, set to Surplus), `surplusLinesBroker` (id), `brokerLicense`, `producerHomeState` (code). Additionally required when `producerHomeState` is New Jersey: `slaNumber`. tailEffectiveDate: type: string format: date description: Tail effective date at policy-activity level (ISO 8601 date string). Leave blank unless a tail period applies to this risk. example: 2026-01-01 fon: $ref: "#/components/schemas/FonActivity" description: >- FON (Final Offer & Negotiation) policy-activity attributes. **CY LOB only.** **Required FON fields:** `fonDate` (date), `jurisdictionCountry` (code), `riskRegulatoryLocation` (code). **Conditional required:** `jurisdictionState` (code) for US risks. The regulatory risk location is found in the Fiscal & Regulatory section of the slip — this represents where the regulator deems the risk to be situated, NOT the territory field. programs: type: array description: RI program associations. Supply when the policy is part of one or more RI program structures. items: type: object required: - programKey properties: programKey: $ref: "#/components/schemas/IdReference" description: Program reference — `id` only. peerReviewRequest: type: object description: Peer review sign-off for the bind. properties: checkedBy: $ref: "#/components/schemas/IdReference" description: Reviewer contact reference — `id` only. checkedDate: type: string format: date description: Date the peer review was completed (ISO 8601 date string). example: 2026-09-10 required: - prebindSanctionCheckComplete ```