HEARTLAND Protocol FHIR Implementation Guide
0.3.0 - United States of America flag

HEARTLAND FHIR candidate 0.3.0 — draft, experimental R4 4.0.1 reference. Prepared for technical review; not evidence of clinical validation or vendor interoperability.

: HEARTLAND Risk Score Codes

Draft as of 2026-09-29

Raw json | Download

{
  "resourceType" : "CodeSystem",
  "id" : "heartland-risk-score",
  "language" : "en",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem heartland-risk-score</b></p><a name=\"heartland-risk-score\"> </a><a name=\"hcheartland-risk-score\"> </a><p>This case-sensitive code system <code>https://fhir.heartlandprotocol.org/CodeSystem/heartland-risk-score</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">heartland-risk-score<a name=\"heartland-risk-score-heartland-risk-score\"> </a></td><td>HEARTLAND Risk Score</td><td>Total of the HEARTLAND risk score, 0 to 18 points. Carried as Observation.valueInteger. A heuristic point count, not a probability.</td></tr><tr><td style=\"white-space:nowrap\">heartland-risk-tier<a name=\"heartland-risk-score-heartland-risk-tier\"> </a></td><td>HEARTLAND Risk Tier</td><td>Qualitative tier derived from the total. Carried as a CodeableConcept drawn from the HeartlandRiskTier code system, typically as an Observation component of the score.</td></tr></table></div>"
  },
  "url" : "https://fhir.heartlandprotocol.org/CodeSystem/heartland-risk-score",
  "version" : "0.3.0",
  "name" : "HeartlandRiskScore",
  "title" : "HEARTLAND Risk Score Codes",
  "status" : "draft",
  "experimental" : true,
  "date" : "2026-09-29T19:00:36-04:00",
  "publisher" : "Vicky Muller Ferreira, MD",
  "contact" : [
    {
      "name" : "Vicky Muller Ferreira, MD",
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://heartlandprotocol.org"
        },
        {
          "system" : "email",
          "value" : "vickymuller@heartlandprotocol.org"
        }
      ]
    },
    {
      "name" : "Vicky Muller Ferreira, MD",
      "telecom" : [
        {
          "system" : "email",
          "value" : "vickymuller@heartlandprotocol.org",
          "use" : "work"
        },
        {
          "system" : "url",
          "value" : "https://heartlandprotocol.org"
        }
      ]
    }
  ],
  "description" : "Codes identifying the HEARTLAND risk score and its tier when either is carried on an Observation rather than on a RiskAssessment — for example an Observation referenced from HeartlandRiskAssessment.basis holding the point total. The score is a non-validated implementation heuristic: the total is a point count, not a probability, and the tier assigns monitoring intensity rather than predicting an outcome.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "US"
        }
      ]
    }
  ],
  "copyright" : "CC-BY 4.0",
  "caseSensitive" : true,
  "content" : "complete",
  "count" : 2,
  "concept" : [
    {
      "code" : "heartland-risk-score",
      "display" : "HEARTLAND Risk Score",
      "definition" : "Total of the HEARTLAND risk score, 0 to 18 points. Carried as Observation.valueInteger. A heuristic point count, not a probability."
    },
    {
      "code" : "heartland-risk-tier",
      "display" : "HEARTLAND Risk Tier",
      "definition" : "Qualitative tier derived from the total. Carried as a CodeableConcept drawn from the HeartlandRiskTier code system, typically as an Observation component of the score."
    }
  ]
}