The FHIR R4 DiagnosticReport resource represents the results of diagnostic testing performed on a patient, typically by a laboratory, imaging facility, or other diagnostic provider. It includes detailed findings, the tests performed, and may include interpretations or recommendations based on the results.
Health Gorilla exposes DiagnosticReport as part of its FHIR R4 API to support patient-centric access to laboratory, imaging, and other diagnostic results.
Use Cases
- Retrieving diagnostic reports for lab results
- Supporting clinical decision-making with test results
- Generating and sharing diagnostic summaries
- Tracking patient progress via diagnostic reports
Scope and Behavior
This documentation describes the FHIR R4 API interface for DiagnosticReport. Health Gorilla’s platform may use additional internal services and data standards to acquire, normalize, and route clinical information. Only the FHIR R4–exposed behavior is documented here.
Health Gorilla supports a subset of the HL7 FHIR R4 DiagnosticReport resource. Not all optional elements defined in the HL7 specification may be stored, indexed, or returned. Unsupported or unrecognized elements may be ignored or normalized during processing.
In Health Gorilla, DiagnosticReport is most commonly accessed as part of patient record retrieval workflows, where diagnostic data may be aggregated from connected clinical sources and normalized for longitudinal review. This resource supports laboratory result review, imaging interpretation access, and diagnostic summary workflows.
Authentication
All requests to the FHIR R4 API require OAuth 2.0 authentication using a bearer token. Unauthorized requests return 401 Unauthorized responses.
Required scopes:
diagnosticreport.readfor GETdiagnosticreport.writefor POST, PUT, DELETE
For more information, go to: OAuth 2.0 Authentication.
Search Behavior
Searches are scoped to the authenticated tenant. The patient parameter is required for patient-scoped searches and is recommended for most search use cases.
Results are returned as a FHIR Bundle. Pagination may be applied. Use standard FHIR pagination links (Bundle.link) to retrieve additional result pages.
Note: Supported parameters and behavior may vary by configuration.
Search Parameters
DiagnosticReport supports several search forms. Provide patient to scope to one patient, or identifier or based-on to retrieve reports directly.
| Parameter | Required | Description |
|---|---|---|
patient | No | The patient whose reports you want, as Patient/{id}. You can also search by a patient identifier using patient.identifier. |
identifier | Required in the identifier search | Returns the report carrying the given identifier. |
based-on | Required in the order search | Returns the reports produced for the given order, as ServiceRequest/{id}. |
category | No | Filters on the report category. |
status | No | Filters on the report status. |
code | No | Filters on the report code. |
date | No | Filters on the clinical date the report applies to, DiagnosticReport.effective. |
encounter | No | Returns reports recorded during the given encounter, as Encounter/{id}. |
_lastUpdated | No | Filters on when the record was last written in the Health Gorilla FHIR server. Accepts a comparison prefix, for example ge2025-01-01. |
_offset | No | Skips the given number of results. |
_count | No | Limits the number of results returned per page. |
_tag | No | Filters on meta.tag. |
_security | No | Filters on meta.security. |
The search also accepts _include=DiagnosticReport:subject, _include=DiagnosticReport:result, _include=DiagnosticReport:basedOn, and _include=Observation:related-target to return referenced resources, and _revinclude=Provenance:target to return the Provenance records describing where the results came from.
Resource Attributes
| Attribute | Description | Example Values | FHIR Data Type |
|---|---|---|---|
subject | Reference to the patient for whom the diagnostic report is issued | Patient/{id} | Reference(Patient) |
status | Current status of the diagnostic report | final | code |
code | Type of diagnostic test or observation performed | LOINC codes | CodeableConcept |
issued | Date and time when the report was issued | 2024-02-12T12:34:56Z | dateTime |
category | Category of the diagnostic report | laboratory | CodeableConcept[] |
result | Observations associated with the diagnostic report | Observation/{id} | Reference[] |
conclusion | Summary of findings or interpretations of the report | Free text | string |
Notifications
The FHIR R4 API does not provide direct resource-change subscriptions for DiagnosticReport. Changes to diagnostic report information may surface through broader notification workflows, depending on enabled Health Gorilla products and configuration.
Error Handling
All DiagnosticReport operations follow standard Health Gorilla error handling, including use of FHIR OperationOutcome for structured responses. For more information, go to: Error Handling.