Skip to content

Policy

A bound insurance policy — the central resource in the BIND standard. Represents an active (or historical) contract between a carrier and an insured, providing specific coverages for a defined period.

Structure

NameCard.TypeDescription
RPolicyA bound insurance policy — the central resource in the BIND standard.
resourceType1..1"Policy"Fixed resource type discriminator
id0..1stringLogical id of this resource.
meta0..1MetaMetadata about the resource
status1..1active | pending | cancelled | expired | non-renewedCurrent status of the policy.
policyNumber1..1stringThe policy number assigned by the carrier.
insured1..1ReferenceReference to the insured entity
carrier1..1ReferenceReference to the issuing carrier
broker0..1ReferenceReference to the broker/agent of record
mga0..1ReferenceReference to the managing general agent (MGA), if applicable
effectivePeriod1..1PeriodThe period during which this policy provides coverage
[ ]linesOfBusiness0..*CodeableConceptLines of business covered by this policy. terminology
totalPremium0..1MoneyTotal annual premium
minimumPremium0..1MoneyMinimum earned premium (if applicable)
commission0..1CommissionStructured commission arrangement (replaces commissionPercentage)
[ ]risks0..*ReferenceReferences to Risk resources associated with this policy
underwriter0..1ReferenceReference to the underwriter (PersonRole) assigned to this policy
accountManager0..1ReferenceReference to the account manager (PersonRole) for this policy
boundDate0..1stringDate/time the policy was bound.
cancelledDate0..1stringDate/time the policy was cancelled, if applicable.
cancellationReason0..1CodeableConceptReason for cancellation, if applicable. terminology
coverageForm0..1CodeableConceptPolicy form (e.g., occurrence, claims-made). terminology
retroactiveDate0..1stringRetroactive date for claims-made policies.
[ ]coverages0..*ReferenceReferences to the individual coverage sections
[ ]endorsements0..*EndorsementEndorsements applied to this policy
originatingQuote0..1ReferenceReference to the quote that this policy was bound from
[ ]documents0..*AttachmentPolicy documents (dec page, forms, endorsements)
transactionType0..1CodeableConceptType of policy transaction (new-business, endorsement, renewal, etc.) terminology
billingMethod0..1CodeableConceptBilling method for premium collection. terminology
billingFrequency0..1CodeableConceptPremium payment frequency. terminology
language0..1stringPreferred language for policy documents (BCP-47 tag, e.g.
[ ]additionalInterests0..*AdditionalInterestAdditional interested parties — mortgagees, loss payees, additional insureds
[ ]transactions0..*PolicyTransactionPolicy lifecycle transaction history
[ ]forms0..*InsuranceFormStandard form references attached to this policy
[ ]notes0..*ReferenceReferences to Note resources for this policy

Example

json
{
  "resourceType": "Policy",
  "id": "pol-2025-1001",
  "status": "active",
  "policyNumber": "CGL-2025-001001",
  "insured": {
    "reference": "Insured/ins-001",
    "display": "Acme Manufacturing Corp"
  },
  "carrier": {
    "reference": "Organization/carrier-200",
    "display": "Hartford Financial"
  },
  "effectivePeriod": {
    "start": "2025-07-01",
    "end": "2026-07-01"
  },
  "linesOfBusiness": [
    {
      "coding": [
        {
          "code": "GL",
          "display": "General Liability"
        }
      ]
    }
  ],
  "totalPremium": {
    "value": 85000,
    "currency": "USD"
  },
  "boundDate": "2025-06-10T16:00:00Z"
}

JSON Schema

Full JSON Schema: Policy.schema.json