HEARTLAND Protocol FHIR Implementation Guide
0.3.0 -
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.
| Draft as of 2026-09-29 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="heartland-risk-score"/>
<language value="en"/>
<text>
<status value="generated"/>
<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>
</text>
<url
value="https://fhir.heartlandprotocol.org/CodeSystem/heartland-risk-score"/>
<version value="0.3.0"/>
<name value="HeartlandRiskScore"/>
<title value="HEARTLAND Risk Score Codes"/>
<status value="draft"/>
<experimental value="true"/>
<date value="2026-09-29T19:00:36-04:00"/>
<publisher value="Vicky Muller Ferreira, MD"/>
<contact>
<name value="Vicky Muller Ferreira, MD"/>
<telecom>
<system value="url"/>
<value value="https://heartlandprotocol.org"/>
</telecom>
<telecom>
<system value="email"/>
<value value="vickymuller@heartlandprotocol.org"/>
</telecom>
</contact>
<contact>
<name value="Vicky Muller Ferreira, MD"/>
<telecom>
<system value="email"/>
<value value="vickymuller@heartlandprotocol.org"/>
<use value="work"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://heartlandprotocol.org"/>
</telecom>
</contact>
<description
value="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 value="urn:iso:std:iso:3166"/>
<code value="US"/>
</coding>
</jurisdiction>
<copyright value="CC-BY 4.0"/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="2"/>
<concept>
<code value="heartland-risk-score"/>
<display value="HEARTLAND Risk Score"/>
<definition
value="Total of the HEARTLAND risk score, 0 to 18 points. Carried as Observation.valueInteger. A heuristic point count, not a probability."/>
</concept>
<concept>
<code value="heartland-risk-tier"/>
<display value="HEARTLAND Risk Tier"/>
<definition
value="Qualitative tier derived from the total. Carried as a CodeableConcept drawn from the HeartlandRiskTier code system, typically as an Observation component of the score."/>
</concept>
</CodeSystem>