BindRequest
objectPolicy-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.
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 contact reference — id only.
Show Child Parameters
Major peril classification — id only. Server-derived from the risk’s class; supply here to override the derivation.
Show Child Parameters
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.
Show Child Parameters
Type of RI basis — id only. Required for Assumed (RI) business. Leave blank for Direct business.
Show Child Parameters
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
Whether prior acts cover applies to this risk.
Example:true
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
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
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
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 (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
RI program associations. Supply when the policy is part of one or more RI program structures.
Show Child Parameters
Peer review sign-off for the bind.
Show Child Parameters
IdReference
objectReference to a lookup-backed entity identified by id (the XFI lookup id, environment-specific).
XFI lookup id — the canonical identifier (environment-specific).
Example:260
CodeReference
objectReference to a lookup-backed entity identified by code (the environment-stable business code).
SubmissionInsured
objectInsured 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.
Required when creating a new insured (i.e. insureContacts is not provided). Legal company name as stated in the submission documentation.
Example:Veritas Capital
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
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
Example:123 Cedar Street
Example:Green Bay
Optional if insureContacts is provided.
Example:underwriting@veritascap.com
Post code / zip for the insured mailing address. Required when creating a new insured and the insured’s country uses postal codes.
Example:54304
Conditional — Political Risk only. Obligor contact reference — id only.
Show Child Parameters
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.
Show Child Parameters
SubmissionProducer
objectProducer (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.
Required. XFI contact key of the producer (broker company). id only.
Example:2000556
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"}}