FHIR R4 Symptoms Implementation Guide, published by HL7 International / Clinical Interoperability Council. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-symptoms-ig/ and changes regularly. See the Directory of published versions
| Page standards status: Informative |
In clinical documentation, symptoms represent the subjective evidence of a health state, typically experienced and reported by the patient (e.g., “fatigue,” “chest pain,” “nausea”).
In contrast, diagnoses represent the clinical interpretation or determination of an underlying condition that explains one or more symptoms or findings (e.g., “pneumonia,” “myocardial infarction,” “anemia”).
Within FHIR, these two types of information are represented by distinct but complementary resources:
| Clinical Concept | FHIR Resource | Typical Coding Systems | Description |
|---|---|---|---|
| Symptom | Observation | SNOMED CT, LOINC | Captures the presence, absence, severity, or characteristics of a symptom as reported by a patient or observed by a clinician. |
| Diagnosis | Condition | SNOMED CT, ICD-10, ICD-11 | Represents the clinician’s diagnostic conclusion or disease identification that accounts for one or more symptoms and findings. |
Both resource types may coexist within a patient record and are often linked to support clinical reasoning, quality measurement, and decision support use cases.
FHIR provides multiple mechanisms to establish relationships between Observations representing symptoms and Conditions representing diagnoses.
The primary mechanism for associating a Condition with supporting evidence is the Condition.evidence.detail element.
This allows a Condition to reference one or more Observations (symptoms, test results, or other findings) that informed the diagnostic conclusion.
When documenting a symptom Observation, the Observation associated Symptom or Condition extension element can link that symptom to a known or suspected Condition that it relates to.
Patient Experience → Symptom (Observation) → Clinical Interpretation → Diagnosis (Condition)
Condition.evidence.detail to maintain a traceable, computable link between diagnostic conclusions and their supporting findings.Observation.hasMember, or captured together via a Questionnaire/QuestionnaireResponse or an Observation panel.effective[x] elements on Observations and Conditions to accurately reflect timing and sequence.Condition.verificationStatus) to clarify whether a diagnosis is provisional, confirmed, or refuted.| Aspect | Symptom (Observation) | Diagnosis (Condition) |
|---|---|---|
| Clinical Nature | Manifestation experienced or observed | Underlying cause or interpretation |
| Primary FHIR Resource | Observation |
Condition |
| Relationship Element | Observation.extension:associatedSymptomOrCondition |
Condition.evidence.detail |
| Typical Codes | SNOMED CT (e.g., Pain in chest), LOINC (e.g., Severity of nausea) | SNOMED CT, ICD-10 (e.g., Pneumonia, Migraine) |
| Example Relationship | Symptom supports one or more Conditions | Condition references multiple supporting Observations |
Best Practice: Use
Condition.evidence.detailto link Conditions to the Observations (Symptoms) that support them. Optionally useObservation.extension:assocaitedSymptomOrConditointo indicate the reverse relationship. Ensure consistent coding, provenance, and temporal alignment to support computable reasoning and interoperability.