Skip to content

Deductible

A structured deductible definition for a coverage section. Replaces the inline Money deductible and separate deductibleType fields, capturing the full complexity of insurance deductible structures including SIRs, corridors, franchises, and disappearing deductibles.

Structure

NameCard.TypeDescription
RDeductibleA structured deductible definition for a coverage section.
amount0..1MoneyThe deductible amount (required for fixed-amount deductibles, optional for percentage-based)
type1..1CodeableConceptHow the deductible applies. terminology
application0..1CodeableConceptHow loss adjustment expenses (ALAE/LAE) interact with the deductible. terminology
isSIR0..1booleanWhether this is a Self-Insured Retention (SIR) rather than a traditional deductible.
aggregateAmount0..1MoneyAggregate cap on deductible obligations in a policy period
corridorPercentage0..1numberCorridor percentage (used in corridor deductible structures).
franchiseAmount0..1MoneyFranchise deductible threshold — losses below this are fully retained; above, fully covered
disappearingThreshold0..1MoneyDisappearing deductible threshold — deductible phases out above this loss amount
percentage0..1numberPercentage-based deductible (e.g., 2% hurricane deductible).
percentageBasis0..1CodeableConceptWhat the percentage is applied to (e.g., "Coverage A dwelling value", "total insured value")
description0..1stringFree-text description of deductible terms

Example

json
{
  "amount": {
    "value": 25000,
    "currency": "USD"
  },
  "type": "per-occurrence",
  "application": "loss-only",
  "isSIR": false,
  "aggregateAmount": {
    "value": 100000,
    "currency": "USD"
  }
}

JSON Schema

Full JSON Schema: Deductible.schema.json