FHIR Reference Data Type (R4)

Reference links one resource to another. Element table, example JSON and FHIRPath for FHIR R4.

  • FHIR Reference Data Type (R4) — part of the free FHIR Toolbox library.
  • Runs entirely in your browser: your FHIR data is never uploaded to a server.

Overview

Reference links one resource to another. It can hold a literal reference (Patient/123 or an absolute URL), a logical identifier, and a display string.

Elements

ElementTypeCardinalityDescription
Reference.referencestring0..1Literal reference, Relative, internal or absolute URL
Reference.typeuri0..1Type the reference refers to (e.g. "Patient")
Reference.identifierIdentifier0..1Logical reference, when literal reference is not known
Reference.displaystring0..1Text alternative for the resource

Example JSON (R4)

{
  "reference": "Patient/example",
  "type": "Patient",
  "display": "John Smith"
}

FHIRPath

  • Observation.subject.reference — Reference string
  • Bundle.entry.resource.ofType(Observation).subject.reference — Subjects of Observations in a Bundle

FHIR Toolbox is a free, privacy-first collection of HL7 FHIR utilities by Omindra Labs. Every tool performs zero-server processing — your health data never leaves your device.