Nerve
FHIRResources

Observation

Maturity LevelSecurity CategoryResource Category
NormativePatient
Clinical

Measurements and simple assertions made about a patient, device or other subject.

Resource Content

Name
Required
Type
Description & Constraints
identifierIdentifierBusiness Identifier for observation
basedOnReference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)Fulfills plan, proposal or order
partOfReference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
statuscoderegistered | preliminary | final | amended +
categoryCodeableConceptClassification of type of observation
codeCodeableConceptType of observation (code / type)
subjectReference(Patient | Group | Device | Location)Who and/or what the observation is about
focusReference(Any)What the observation is about, when it is not about the subject of record
encounterReference(Encounter)Healthcare event during which this observation is made
effective[x]*Clinically relevant time/time-period for observation
└─ effectiveDateTimedateTimeDate/time of observation
└─ effectivePeriodPeriodPeriod of observation
└─ effectiveTimingTimingTiming of observation
└─ effectiveInstantinstantInstant of observation
issuedinstantDate/Time this version was made available
performerReference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)Who is responsible for the observation
value[x]Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | PeriodActual result*
dataAbsentReasonCodeableConceptWhy the result is missing
interpretationCodeableConceptHigh, low, normal, etc.
noteAnnotationComments about the observation
bodySiteCodeableConceptObserved body part
methodCodeableConceptHow it was done
specimenReference(Specimen)Specimen used for this observation
deviceReference(Device | DeviceMetric)(Measurement) Device
referenceRange*Provides guide for interpretation
└─ lowQuantityLow Range
└─ highQuantityHigh Range
└─ typeCodeableConceptReference range qualifier
└─ appliesTo*Reference range population
└─ ageRangeApplicable age range
└─ textstringText based reference range
hasMemberReference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
derivedFromReference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)Related measurements the observation is made from
component*Component results
└─ codeCodeableConceptType of component observation
└─ value[x]Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | PeriodActual component result*
└─ dataAbsentReasonCodeableConceptWhy the component result is missing
└─ interpretationCodeableConceptHigh, low, normal, etc.
└─ referenceRange*Provides guide for interpretation of component result
signatureSignatureDigital Signature

Search Parameters

NameTypeDescriptionExpression
codetokenThe code of the observation typeObservation.code
datedateObtained date/time. If the obtained element is a period, a date that falls in the periodObservation.effective
identifiertokenThe unique id for a particular observationObservation.identifier
patientreferenceThe subject that the observation is about (if patient)Observation.subject.where(resolve() is Patient)
encounterreferenceEncounter related to the observationObservation.encounter
based-onreferenceReference to the service request.Observation.basedOn
categorytokenThe classification of the type of observationObservation.category
combo-codetokenThe code of the observation type or component typeObservation.code | Observation.component.code
combo-data-absent-reasontokenThe reason why the expected value in the element Observation.value[x] or Observation.component.value[x] is missing.Observation.dataAbsentReason | Observation.component.dataAbsentReason
combo-value-concepttokenThe value or component value of the observation, if the value is a CodeableConceptObservation.value as CodeableConcept | Observation.component.value as CodeableConcept
combo-value-quantityquantityThe value or component value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)Observation.value as Quantity | Observation.value as SampledData | Observation.component.value as Quantity | Observation.component.value as SampledData
component-codetokenThe component code of the observation typeObservation.component.code
component-data-absent-reasontokenThe reason why the expected value in the element Observation.component.value[x] is missing.Observation.component.dataAbsentReason
component-value-concepttokenThe value of the component observation, if the value is a CodeableConceptObservation.component.value as CodeableConcept
component-value-quantityquantityThe value of the component observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)Observation.component.value as Quantity | Observation.component.value as SampledData
data-absent-reasontokenThe reason why the expected value in the element Observation.value[x] is missing.Observation.dataAbsentReason
derived-fromreferenceRelated measurements the observation is made fromObservation.derivedFrom
devicereferenceThe Device that generated the observation data.Observation.device
focusreferenceThe focus of an observation when the focus is not the patient of record.Observation.focus
has-memberreferenceRelated resource that belongs to the Observation groupObservation.hasMember
methodtokenThe method used for the observationObservation.method
part-ofreferencePart of referenced eventObservation.partOf
performerreferenceWho performed the observationObservation.performer
specimenreferenceSpecimen used for this observationObservation.specimen
statustokenThe status of the observationObservation.status
subjectreferenceThe subject that the observation is aboutObservation.subject
value-concepttokenThe value of the observation, if the value is a CodeableConceptObservation.value as CodeableConcept
value-datedateThe value of the observation, if the value is a date or period of timeObservation.value as dateTime | Observation.value as Period
value-quantityquantityThe value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)Observation.value as Quantity | Observation.value as SampledData
value-stringstringThe value of the observation, if the value is a string, and also searches in CodeableConcept.textObservation.value as string | Observation.value as CodeableConcept.text
code-value-conceptcompositeCode and coded value parameter pairObservation
code-value-datecompositeCode and date/time value parameter pairObservation
code-value-quantitycompositeCode and quantity value parameter pairObservation
code-value-stringcompositeCode and string value parameter pairObservation
combo-code-value-conceptcompositeCode and coded value parameter pair, including in componentsObservation.component
combo-code-value-quantitycompositeCode and quantity value parameter pair, including in componentsObservation.component
component-code-value-conceptcompositeComponent code and component coded value parameter pairObservation.component
component-code-value-quantitycompositeComponent code and component quantity value parameter pairObservation.component

Scope and Usage

Observations are a central element in healthcare, used to support diagnosis, monitor progress, determine baselines and patterns and even capture demographic characteristics. Most observations are simple name/value pair assertions with some metadata, but some observations group other observations together logically, or even are multi-component observations.

Common Use Cases

  • Vital Signs
    • Body weight
    • Blood pressure
    • Temperature
  • Laboratory Data
    • Blood glucose
    • Estimated GFR
  • Imaging Results
    • Bone density
    • Fetal measurements
  • Clinical Findings*
    • Abdominal tenderness
  • Device Measurements
    • EKG data
    • Pulse Oximetry data
  • Clinical Assessment Tools
    • APGAR score
    • Glasgow Coma Score
  • Personal and Social Information
    • Personal characteristics (e.g., eye color)
    • Social history (e.g., tobacco use, family support)
    • Core characteristics (e.g., pregnancy status, death assertion)

*Note: The boundaries between clinical findings and disorders remains a challenge in medical ontology. These boundaries can be clarified by profiling Observation for a particular use case.

Boundaries and Relationships

Primary Purpose

  • Observation is intended for capturing measurements and subjective point-in-time assessments
  • Supports name-value pairs or structured collections of name-value pairs

Instead of Observation, use these specialized resources when appropriate:

Resource TypeUse Case
AllergyIntolerancePatient allergies
MedicationStatementMedications taken by patient
FamilyMemberHistoryPatient's family history
ProcedureProcedure information
QuestionnaireResponseAnswers to questions
ConditionClinical diagnoses
ClinicalImpressionClinical assessments
MediaAudio, video, or image data
DiagnosticReportLaboratory, pathology, and imaging reports

Special Considerations

Relationship with DiagnosticReport

  • DiagnosticReport provides clinical context for a set of observations
  • DiagnosticReport includes:
    • Additional clinical context
    • Atomic results
    • Images and imaging reports
    • Textual and coded interpretation
    • Formatted representations
  • Observation is referenced by DiagnosticReport for atomic results

Edge Cases

  1. Overlapping Scenarios

    • Some data could fit multiple resources (e.g., illicit drug use could be MedicationStatement or Observation)
    • Convention and common practice often guide the choice
  2. Legacy Data

    • When importing HL7 v2 data, specialized observations may appear in this resource due to limited source information
    • This is considered appropriate use of Observation
  3. Implementation Guidance

    • If uncertain about appropriate use, consult with implementers on chat.fhir.org implementer's stream

Referenced Elements

This resource is referenced by:

On this page