Skip to content

Risk

An insurable risk item — the most architecturally significant domain resource.

  • riskType identifies what kind of insurable thing this is
  • characteristics[] capture structured attributes
  • values[] capture financial valuations

Structure

NameCard.TypeDescription
RRiskAn insurable risk item — the most architecturally significant domain resource.
resourceType1..1"Risk"Fixed resource type discriminator
id0..1stringLogical id of this resource.
meta0..1MetaMetadata about the resource
status1..1active | inactive | pending | disposedCurrent status of this risk item
riskType1..1CodeableConceptThe type of insurable risk. terminology
description0..1stringFree-text description of the risk
insured0..1ReferenceReference to the insured who owns or is responsible for this risk
location0..1ReferenceReference to the physical location of this risk (for property-based risks)
[ ]characteristics0..*RiskCharacteristicStructured attributes of the risk (polymorphic value pattern)
[ ]values0..*AssetValuationFinancial valuations of the risk
[ ]classifications0..*CodeableConceptRisk classifications (e.g., ISO class codes, NAICS codes, fleet codes)
effectivePeriod0..1PeriodPeriod during which this risk is/was active or covered
[ ]coverages0..*ReferenceReferences to Coverage resources that cover this risk
partOf0..1ReferenceReference to a parent risk (e.g., equipment within a building, trailer attached to a vehicle)
notes0..1stringFree-text notes about this risk
[ ]namedDrivers0..*NamedDriverNamed drivers on a personal auto policy risk
[ ]lienholders0..*LienholderFinancial interest parties (lienholders, loss payees) on this risk
garagingAddress0..1AddressPrimary garaging location for mobile risks (vehicles, trailers)

Example

json
{
  "resourceType": "Risk",
  "id": "risk-veh-001",
  "status": "active",
  "riskType": {
    "coding": [
      {
        "code": "vehicle",
        "display": "Vehicle"
      }
    ]
  },
  "characteristics": [
    {
      "code": {
        "text": "VIN"
      },
      "valueString": "1HGBH41JXMN109186"
    },
    {
      "code": {
        "text": "Year"
      },
      "valueInteger": 2023
    },
    {
      "code": {
        "text": "Make"
      },
      "valueString": "Honda"
    },
    {
      "code": {
        "text": "Model"
      },
      "valueString": "Civic"
    }
  ],
  "values": [
    {
      "type": {
        "text": "Stated Value"
      },
      "amount": {
        "value": 28000,
        "currency": "USD"
      }
    }
  ]
}

JSON Schema

Full JSON Schema: Risk.schema.json