FHIR Resource Dictionary

Overview

There are many considerations that HL7 made when designing the FHIR R4 system. The idea behind individual resources is to quickly and easily pinpoint a specific area of the patient's medical record, whether it’s related to clinical data gathered during a medical visit, the provider who delivered care, or a comprehensive medical history. The data set that Particle Health has access to is largely clinical and based on the USCDI v2 data set. While this required data set is largely clinical today, we expect this to expand to encompass the patient’s entire record down the line.

While FHIR does support 100+ different types of resources, there are 24 distinct clinically-relevant resources that conform to this USCDI v2 data set that Particle has access to via the EMRs and HIEs we connect with. Below is a brief summary of the primary use for each of these resources.

Resource Definitions

ResourceDescription
AllergyIntoleranceThis will often include what the patient is allergic to, how it manifests (i.e. anaphylactic to peanuts), the practitioner who diagnosed the allergy, and the severity of the allergy.
BasicThis is a resource used for any concept that has not yet been defined by FHIR. As such, there isn’t a well-defined set of criteria that dictates what should be included in a Basic resource, but it can include anything from detailed provider notes to referrals.
CarePlanA summary of planned procedures, appointments, or other care-related activities for a patient. This is often forward-looking and can have varying degrees of granularity as defined by the source EMR.
CompositionThe “table of contents” for data that is available on a patient. This often includes reference to all resources that are available for a patient on a document-by-document basis.
ConditionGranularity around diagnoses, clinical conditions, or problems that have been identified by a provider. This often includes the condition name and coding source (i.e. ICD-10)
CoverageHigh-level information about insurance coverage that the patient has (i.e. Medicare, Medicaid, private insurance). We do not receive this information with high frequency, but expect to begin seeing it in higher volume once the draft of the USCDI v3 starts becoming enforced.
DevicePhysical devices that were used as part of an interaction a patient had with a provider. This can be either a medical or non-medical device.
DiagnosticReportA summary resource that contains information about procedures that were ordered (i.e. imaging, tests, etc.), who performed the procedure, and information about any diagnosis that came from the procedure.
DocumentReferenceTypically inclusive of clinical notes dictated by the provider. Additional information on the types of notes to expect can be found here.
EncounterSummary of an interaction between a patient and a provider. Often includes details about the patient, the provider(s) involved, any diagnosis that was determined, the location of care, and other details.
FamilyMemberHistoryHealth conditions or other significant medical diagnoses of a patient’s family.
ImmunizationA log of immunizations that a patient has been administered.
LocationDetails about the physical space where an encounter occurred.
MedicationReferences to the name of a medication that a patient has been prescribed.
MedicationRequestInformation pertaining to the medication prescribed, who it was prescribed to, and instructions for administering (i.e. “take one tablet twice a day”).
MedicationStatementA record that a patient is taking, has taken, or will be taking a particular medication. This will also often have reference to the medication they are prescribed, the time period they are taking it, and dosage information. These are more common than MedicationRequest resources
ObservationMeasurements and assertions about a patient - often recorded during an encounter. Observations typically include things like vital signs, lab results, social history, SDoH values, and other clinical findings.
OrganizationCompanies, corporations, institutions, or practices that are, in one way or another, tied to the patient. These are oftentimes the place where a patient receives care, but could also be a pharmacy, insurer, or other organization.
PatientDemographic details for a patient (i.e. name, DOB, address(s), phone number(s), etc.)
PersonSimilarly to the Patient resource, a Person resource also often contains details for a patient (i.e. name, DOB, address(s), phone number(s), etc.)
PractitionerThe person(s) directly involved in the care of a patient. This spans from physicians to medical assistants to nurses.
PractitionerRoleDetails about what role the provider plays in treating the patient. This includes information on credentials, specialties, and other information about the type of service they provide.
ProcedureAction that was performed on the patient, like an operation, blood draw, therapy, or other related clinical events.
RelatedPersonDetails about a person involved in a patient’s care, but not directly receiving care. This is often a family member, friend, caretaker, or legal guardian.

Did this page help you?