Most resources in Health Gorilla's FHIR API are tied to a specific patient. This page provides a reference guide to all supported resource types that reference or depend on the Patient
resource, grouped by their clinical or operational function.
This overview is useful for developers building patient-centric applications or workflows, especially when using queries like:
GET /[ResourceType]?patient=Patient/{id}
or
GET /Patient/{id}/$everything
Core Clinical Data
These resources represent key elements of a patient's clinical history.
Resource | Description |
---|---|
AllergyIntolerance | Documented allergies or adverse reactions to substances |
Condition | Clinical problems or diagnoses, both active and resolved |
Observation | Lab results, vital signs, screening tools, and clinical measurements |
Procedure | Medical or surgical interventions performed on the patient |
DiagnosticReport | Bundled lab, pathology, and imaging reports |
Immunization | Historical or administered vaccines |
FamilyMemberHistory | Health history of relatives used for risk assessments |
Goal | Desired outcomes set for the patient, such as behavioral or physiological |
Medication Data
Medication resources capture prescriptions, fulfillments, and reconciled medication use.
Resource | Description |
---|---|
MedicationRequest | Ordered medications |
MedicationDispense | Pharmacy dispense records |
MedicationStatement | Self-reported or reconciled medications (e.g., from intake or transfer) |
NutritionOrder | Dietary prescriptions tied to clinical conditions |
Care Planning and Clinical Workflow
These resources describe planned actions, orders, and coordinated care.
Resource | Description |
---|---|
ServiceRequest | Referrals, diagnostic orders, and other requested services |
CarePlan | Plan of care including goals, activities, and responsible parties |
RequestGroup | Grouped service requests or order sets with timing and dependency logic |
Encounter | Inpatient, outpatient, or virtual care events tied to the patient |
CareTeam | Members of the patient’s care team, including roles and organizations |
Documentation and Provenance
These resources capture structured documents and their origins.
Resource | Description |
---|---|
DocumentReference | References to external or internal clinical documents (PDFs, CCDAs, scans) |
Composition | Clinical document structure (e.g., discharge summary, progress note) |
Provenance | Metadata describing who submitted or modified a resource and how |
Communication and Coordination
These resources support messaging, directory functions, and supporting content.
Resource | Description |
---|---|
Communication | Actual messages between parties related to the patient |
CommunicationRequest | Planned or requested messages (e.g., outreach, follow-up reminders) |
List | Used for Record Locator Service (RLS) to return care organizations, labs |
Binary | Raw file content such as scanned documents or image attachments |
Administrative and Support Resources
These are reference or contextual resources that may appear in patient-scoped operations.
Resource | Description |
---|---|
Practitioner | Providers involved in the patient’s care |
PractitionerRole | Provider role, specialty, location, and organization |
Organization | Facility, lab, or clinic responsible for submitted records |
Location | Physical location of service (e.g., department, unit, clinic) |
RelatedPerson | Legal guardian, next of kin, or family caregiver linked to the patient |
Querying Across Patient Resources
Once a patient has been registered or matched, any of the above resources can be queried using the patient ID:
GET /Observation?patient=Patient/abc123
GET /MedicationRequest?patient=Patient/abc123
GET /Encounter?patient=Patient/abc123
To retrieve all aggregated data for a patient, use:
GET /Patient/abc123/$everything
For more information on clinical data retrieval, go to: Patient360 in the FHIR API
Additional Resources
FHIR Patient
FHIR Resource Index
Health Gorilla Webhooks
Health Gorilla Error Handling