DiagnosticReport REST Endpoints

Sort by

Task Path Method

Description

DiagnosticReport

This topic describes information for the DiagnosticReport resource.

Overview

The DiagnosticReport resource provides a set of information and interpretation following a diagnostic service or procedure such as a radiology, pathology, or cardiology report. The DiagnosticReport resource produces information about the diagnostic report itself, about the subject, and about the specimen of the report in the case of laboratory tests. The information produced can include a mix of atomic results, textual reports, images, and codes, depending on the types of diagnostic services being retrieved.

Report conclusions can be expressed as a simple text blob, structured coded data, or as an attached fully formatted report (such as a PDF). Image and media representations of the report and supporting images can be referenced in the DiagnosticReport resource. This resource can retrieve reports of various Status types. Consider these statuses for filtering purposes if you only want to retrieve Final or Corrected results, or if you want to exclude any Entered-in-Error results. See the Status field below for more detail.

If you want to retrieve results without textual reports, such as general laboratory or vital sign results, use the Observation resource instead.

This resource supports the following HL7 FHIR US Core Implementation Guide STU 6.1.0 profiles:

• US Core DiagnosticReport Profile for Laboratory Results Reporting

• US Core DiagnosticReport Profile for Report and Note Exchange

Note:

The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site. The meta.security field is present only when the resource is confidential or when a report contains confidential results. Confidential results contain extensions with their applied confidential labels. See the HL7 FHIR Inline Security Label extension for more information.

Note:

The confidentiality feature is only suppported for laboratory, anatomic pathology, and radiology reports.

The following fields are returned if valued:

• DiagnosticReport ID

• Identifier

• BasedOn

  • Reference (ServiceRequest)

• Status

• Category

• Code

• Subject

  • Reference (Patient)

• Encounter

• Effective

• Date Time

• Period

• Issued date and time

• Performer

  • Reference (Practitioner)

  • Reference (Organization)

• Result Interpreter

  • Reference (Practitioner)

  • Reference (Organization)

• Specimen
  • Reference (Specimen)

• Result

• Media
  • Media Link
    • Reference (Media)

• Presented Form

• Content Type

• URL

• Title

• Creation

• Conclusion Code

Terminology Bindings

• DiagnosticReport.category

  Description: A code that classifies the clinical discipline, department, or diagnostic service that created the report (such as cardiology, biochemistry, hematology, or MRI). This code is used for searching, sorting, and display purposes.

  • Details: US Core DiagnosticReport Profile for Laboratory Results Reporting

    System: http://hl7.org/fhir/v2/0074

  • Details: US Core DiagnosticReport Profile for Report and Note Exchange

    System: http://loinc.org

• DiagnosticReport.code

  Description: A code or name that describes this diagnostic report.

  Details: DiagnosticReport code

  System: http://loinc.org

• DiagnosticReport.status

  Description: The status for the diagnostic report.

  Details: DiagnosticReportStatus

  System: http://hl7.org/fhir/diagnostic-report-status

• DiagnosticReport.conclusionCode

  Description: One or more codes that represent the summary conclusion (interpretation or impression) of the diagnostic report.

  Details: Codes for the clinical conclusion of test results

  System: http://snomed.info/sct

• DiagnosticReport.meta.security

  Description: These tags connect specific resources to the overall security policy and infrastructure.

  Details: ValueSet

  System: http://terminology.hl7.org/CodeSystem/v3-ActCode

Extensions

Inline Security Label (only present for confidential laboratory results)

DiagnosticReport

The operations from the DiagnosticReport category.

Create a diagnostic report

Method: post

Path: /DiagnosticReport

Get a diagnostic report by ID

Method: get

Path: /DiagnosticReport/{ID}

Get a list of diagnostic reports

Method: get

Path: /DiagnosticReport