DiagnosticReport

• Overview
• Terminology Bindings
• Search
  • Authorization Types
  • Parameters
  • Headers
  • Example
  • Errors

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 will produce information about the diagnostic report itself and about the subject.

The information produced can include a mix of textual reports, images, and codes, depending on the type(s) of diagnostic services being retrieved. This resource currently only supports Radiology reports in the presented form of either PDF or HTML.

The following fields are returned if valued:

• Diagnostic report id
• Report status
• Report category
• Code
• Subject (patient)
• Patient encounter
• Effective date/time
• Issued date/time
• Performer (practitioner)
• Request (order)
• Presented Form
  • Content type
  • URL (fully qualified link to the document)
  • Title

Terminology Bindings

DiagnosticReport.category

Description Codes for diagnostic service sections. Details: Diagnostic Service Section Codes System: http://hl7.org/fhir/v2/0074

DiagnosticReport.code

Description Codes that describe Diagnostic Reports. Details: LOINC Diagnostic Report Codes System: http://loinc.org

Search

Search for DiagnosticReports that meet supplied query parameters:

GET /DiagnosticReport?:parameters

Authorization Types

Parameters

Name	Required?	Type	Description
patient	This or subject	reference	The subject of the report if a patient. Example: 12345
subject:Patient	This or patient	reference	The subject (Patient) of the report. Example: 12345
date	N	date	Date range into which the diagnostic report falls (effectiveDateTime). Example: date=ge2020-01-01T08:00:00.000Z&date=lt2020-01-31T17:00:00.000Z
_count	N	number	The maximum number of results to return. Defaults to 10 and a maximum of 100 documents can be returned.

Implementation Notes

• When searching with the date parameter:
  • For a single date occurrence:
    • It must be provided with the ge prefix to imply a date range.
    • The time component is optional.
  • For two date occurences:
    • It must be provided with ge and lt prefixes to search for report(s) within a specific range.
    • The time component is optional for both parameters.
• If a DiagnosticReport references a PDF with URL sections, it may not be returned from the Binary resource. See the Binary implementation notes.
• When requesting the presentedForm.url, the Accept header should be populated with the presentedForm.contentType. For more information, see the Binary accept documentation.

Headers

Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?patient=12724066&_count=10

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "05cb2a6a-1de9-4de9-a3ff-16c1f347f910",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?patient=12724066&_count=10"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport/197198634",
      "resource": {
        "resourceType": "DiagnosticReport",
        "id": "197198634",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2019-12-26T21:36:00.000Z"
        },
        "text": {
          "status": "additional",
          "div": "<div><p><b>Diagnostic Report</b></p><p><b>Document Type</b>: Radiology Reports</p><p><b>Document Title</b>: Admission H &amp; P - Radiology</p><p><b>Effective Date</b>: 2019-12-26T21:35:07.000Z</p><p><b>Issued</b>: 2019-12-26T21:35:59.000Z</p><p><b>Patient</b>: SMART, NANCY</p><p><b>Status</b>: Final</p><p><b>Verifying Provider</b>: Cerner Test, Physician - Hospitalist Cerner</p></div>"
        },
        "status": "final",
        "category": {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v2/0074",
              "code": "RAD",
              "display": "Radiology",
              "userSelected": false
            }
          ],
          "text": "Radiology Reports"
        },
        "code": {
          "text": "Radiology Reports"
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "encounter": {
          "reference": "Encounter/97939518"
        },
        "effectiveDateTime": "2019-12-26T21:35:07.000Z",
        "issued": "2019-12-26T21:35:59.000Z",
        "performer": {
          "reference": "Practitioner/4122622",
          "display": "Cerner Test, Physician - Hospitalist Cerner"
        },
        "presentedForm": [
          {
            "contentType": "text/html",
            "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/TR-197198634",
            "title": "Admission H & P - Radiology"
          },
          {
            "contentType": "application/pdf",
            "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XR-197198634",
            "title": "Admission H & P - Radiology"
          }
        ]
      }
    }
  ]
}

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.

Errors

The common errors and OperationOutcomes may be returned.