BindRequest

object

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.

prebindSanctionCheckCompletebooleanrequired

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

obligorobject

Obligor contact reference — id only.

* Additional properties are NOT allowed.
Show Child Parameters
majorPerilobject

Major peril classification — id only. Server-derived from the risk’s class; supply here to override the derivation.

* Additional properties are NOT allowed.
Show Child Parameters
territoryobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
typeofRIBasisobject

Type of RI basis — id only. Required for Assumed (RI) business. Leave blank for Direct business.

* Additional properties are NOT allowed.
Show Child Parameters
priorPendingstring(date)

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

priorActsboolean

Whether prior acts cover applies to this risk.

Example:true

retroactiveDatestring(date)

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

insuredobject

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).

Show Child Parameters
surplusBrokerobject

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.

Show Child Parameters
tailEffectiveDatestring(date)

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

fonobject

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.

Show Child Parameters
programsarray[object]

RI program associations. Supply when the policy is part of one or more RI program structures.

Show Child Parameters
peerReviewRequestobject

Peer review sign-off for the bind.

Show Child Parameters
Example

IdReference

object

Reference to a lookup-backed entity identified by id (the XFI lookup id, environment-specific).

* Additional properties are NOT allowed.
idstringrequired

XFI lookup id — the canonical identifier (environment-specific).

Example:260

Example

CodeReference

object

Reference to a lookup-backed entity identified by code (the environment-stable business code).

* Additional properties are NOT allowed.
codestringrequired
Example

SubmissionInsured

object

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.

companyNamestring

Required when creating a new insured (i.e. insureContacts is not provided). Legal company name as stated in the submission documentation.

Example:Veritas Capital

domicileCountryobject

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"}

Show Child Parameters
domicileStateobject

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"}

Show Child Parameters
mailingAddress1string

Example:123 Cedar Street

mailingAddressCitystring

Example:Green Bay

emailstring(email)

Optional if insureContacts is provided.

Example:underwriting@veritascap.com

zipCodestring

Post code / zip for the insured mailing address. Required when creating a new insured and the insured’s country uses postal codes.

Example:54304

obligorobject

Conditional — Political Risk only. Obligor contact reference — id only.

* Additional properties are NOT allowed.
Show Child Parameters
insureContactsobject

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.

* Additional properties are NOT allowed.
Show Child Parameters
Example

SubmissionProducer

object

Producer (broker) reference used on a submission. id identifies the producer (broker company). Optionally include a contactliaison block to attach, create, or update the broker contact liaison recorded on the policy.

idstringrequired

Required. XFI contact key of the producer (broker company). id only.

Example:2000556

contactliaisonobject

Optional. Broker contact liaison to record on the policy. See ContactLiaisonSubmission for the attach/create/update behavior.

Example:{"firstName":"John","lastName":"Smith","email":"Yes@example.com","phoneNo":"9000000000","mobilePhone":"899 898 09","faxNo":"45","state":{"code":"UT"},"city":{"description":"Green Bay"},"region":{"description":"GBR"},"contactliaisonid":{"id":"1234"}}

Show Child Parameters
Example