The Opala Patient Access API CARIN for Blue Button® Da Vinci Payer Data Exchange (PDex)
Overview: Resources and Interactions Overview: API Searches
Opala FHIR Documentation

© 2021 Opala. All Rights Reserved.

Version 1.0


Contact Opala's
Documentation Team

DiagnosticReport

A diagnostic report is the set of information typically provided by a diagnostic service when investigations are complete. The information includes a mix of atomic results, text reports, images, and codes. The mix varies depending on the nature of the diagnostic procedure, and sometimes on the nature of the outcomes for a particular investigation.

The DiagnosticReport resource includes findings and interpretation of diagnostic tests performed on patients, groups of patients, devices, and locations, and/or the specimens derived from these. The report includes clinical context (e.g., requesting and provider information) and some mix of atomic results, images, textual and coded interpretations, and formatted representations of diagnostic reports. Laboratory reports, pathology reports, and imaging reports should be represented using the DiagnosticReport resource.

The DiagnosticReport resource is suitable for the following types of diagnostic reports:

The DiagnosticReport resource inbcludes information about the diagnostic report itself, as well as information about the subject and, in the case of laboratory tests, the specimen of the report.

Note: The DiagnosticReport resource is not intended to support cumulative result presentation. The resource does not yet provide full support for detailed structured reports of sequencing; this is planned for a future release.

The DiagnosticReport resource uses one particular set of terms when describing the various parts of a diagnostic report.

Typically, a report is either all data, no narrative (e.g., Core lab); a mix of data with some concluding narrative (e.g., Structured Pathology Report, Bone Density); or all narrative (e.g., a typical imaging report, histopathology). The DiagnosticReport resource provides for these 3 different presentations:

Related Resources

The DiagnosticReport resource is referenced by these resources:

C D-M M-S
CarePlan DeviceRequest MedicationStatement
ChargeItem DeviceUseStatement Procedure
ClinicalImpression FamilyMemberHistory RequestGroup
Communication GuidanceResponse RiskAssessment
CommunicationRequest ImagingStudy ServiceRequest
Condition Immunization SupplyRequest
Contract MedicationAdministration

Where there are details of interest about how the diagnostic procedure was performed, the Procedure resource is used to describe the activity.

The Observation resource is referenced by the DiagnosticReport to provide the atomic results for a particular investigation.

For a more narrative driven report with less workflow (e.g., histology/mortuary, etc.), using the Composition resource is more appropriate.

Image and media representations of the report and its supporting images are referenced in the DiagnosticReport resource. The details for and actual image instances can be referenced directly in the Diagnostic report using the imaging element, or by indirect reference through ImagingStudy resources.

Note: ImagingStudy and ImageObjectStudy and the media element are somewhat overlapping. Usually, the list of image references in the image element will also be found in one of the imaging study resources.

US Core

The following links define the Value Set and various Search Parameters for the US Core DiagnosticReport:

Mandatory Search Parameters

The following search parameters and search parameter combinations should be supported.

Searching for all diagnosticreports for a patient using the patient search parameter:

GET [base]/DiagnosticReport?patient=[reference]

Searching using the combination of the patient and category search parameters:

GET [base]/DiagnosticReport?patient=[reference]&category={system|}[code]

Searching using the combination of the patient and code search parameters, including optional support for composite OR search on code (e.g., code={system|}[code],{system|}[code],...):

GET [base]/DiagnosticReport?patient=[reference]&code={system|}[code]{,{system|}[code],...}

Searching using the combination of the patient and category and date search parameters, including support for these date comparators: gt, lt, ge, le. Optionally, the profile supports composite AND searches on date (e.g., date=[date]&date=[date]]&...):

GET [base]/DiagnosticReport?patient=[reference]&category={system|}[code]&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

For a list of optional search parameters, see StructureDefinition-us-core-diagnosticreport-note

For More Information