Get a list of diagnostic reports

get

/DiagnosticReport

Retrieves a list of diagnostic reports that meet supplied query parameters.

Note: Diagnostic reports of the General Laboratory, Microbiology, and Cardiology types populate the DiagnosticReport.results field.

Authorization Types

This operation supports the following authorization types:

Request

Query Parameters
  • The maximum number of results to return. Defaults to 10 and a maximum of 100 documents can be returned.
  • The logical resource ID. This parameter is required if the patient parameter is not used.
    Example: _id=12345
  • The date range in which the diagnostic report was last updated.
    • This parameter may be provided up to two times, and must use the eq, ge, gt, le, or lt prefixes.
    • When a value is provided without a prefix, an implied eq prefix is used.
    • When provided twice, the lower value must have a ge or gt prefix and the higher value must have an le or lt prefix.
    • The _lastUpdated parameter may not be provided at the same time as the date parameter.
    Example: _lastUpdated=gt2014-09-24 or _lastUpdated=gt2014-09-24T12:00:00.000Z
  • The Provenance resource entries to be returned as part of the bundle.
    • May be provided once with the Provenance:target value. Example: _revinclude=Provenance:target.
    • May be provided with the _id or patient parameters. Example: _id=214938095&_revinclude=Provenance:target.
    • When _revinclude is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding with the authorization type, such as user/Provenance.read, patient/Provenance.read, or system/Provenance.read.
    Example: _revinclude=Provenance:target
  • The diagnostic discipline or department that created the report.
    Example:
    category=http://terminology.hl7.org/CodeSystem/v2-0074|LAB
    or
    category=http://loinc.org|LP29684-5
  • The specific code for describing the report.
    Example:
    code=http://loinc.org|24323-8
  • The date range that the diagnostic report falls within (effectiveDateTime).
    • May provide one or two dates and times.
    • For a single date occurrence:
      • May be provided with a prefix to imply a date range or without a prefix to search for reports last updated at a specific date and time.
      • The time component is optional.
    • For two date occurences:
      • Must be provided with le or lt and ge or gt prefixes to search for reports within a specific range.
      • The time component is required for both parameters.
    • The date parameter may not be provided at the same time as the _lastUpdated parameter.
    Example: date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z
  • The encounter when the order was made.
    • Must represent an Encounter resource.
    • Patient-level documents are filtered out from responses when the encounter ID is zero or blank.
    • May include a single value or comma-separated list of references. Example: encounter=12345,67890.
    Example: encounter=1621910
  • The subject of the report if a patient. This parameter is required if the _id parameter is not used.
    Example: patient=67890
Header Parameters
Back to Top

Response

Supported Media Types

Default Response

Example search by patient and category.
Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?patient=12724066&category=http://terminology.hl7.org/CodeSystem/v2-0074|RAD
Example Response:
{
    "resourceType": 'Bundle',
    "id": '4e95721b-490b-4c57-84f5-7d055a8a5dec',
    "type": 'searchset',
    "link": [
      {
        "relation": 'self',
        "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?patient=12724066&category=http%3A%2F%2Fterminology.hl7.org%2FCodeSystem%2Fv2-0074%7CRAD'
      },
      {
        "relation": 'next',
        "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?patient=12724066&category=http%3A%2F%2Fterminology.hl7.org%2FCodeSystem%2Fv2-0074%7CRAD&-pageContext=eJwdyk0KwjAURtG9fOME8jTNT8GJbqBQcVpCmtaCJJImKJTu3eLwHu4Gn2osaEkwjGFy9XXEBl_zmjJa3Lqclofsr59lpq7eSy8vYHi6dYjhe7wl18DwdnMYfIrlb2hO9mxISG61aLgkIbihMHIySupJKU3WYd9_FHYmXg%3D%3D&-pageDirection=NEXT'
      }
    ],
    "entry": [
      {
        "fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport/197369077',
        "resource": {
          "resourceType": 'DiagnosticReport',
          "id": '197369077',
          "meta": {
            "versionId": '1',
            "lastUpdated": '2020-08-13T19:36:06.000Z'
          },
          "text": {
            "status": 'generated',
            "div": '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Diagnostic Report</b></p><p><b>Patient</b>: Smart II, Nancy</p><p><b>Document Title</b>: Some Title 4x</p><p><b>Status</b>: Final</p><p><b>Code</b>: Radiology Reports</p><p><b>Effective End Date</b>: Aug 13, 2020  7:36 P.M. UTC</p><p><b>Verifying Provider</b>: Portal, Portal</p></div>'
          },
          "identifier": [
            {
              "system": 'https://fhir.cerner.com/ceuuid',
              "value": 'CE87caf4b7-9397-4667-9897-702218017c9e-197369077-2020081319360600'
            }
          ],
          "status": 'final',
          "category": [
            {
              "coding": [
                {
                  "system": 'http://loinc.org',
                  "code": 'LP29684-5',
                  "userSelected": false
                }
              ],
              "text": 'Radiology'
            }
          ],
          "code": {
            "coding": [
              {
                "system": 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/72',
                "code": '63293819',
                "display": 'Radiology Reports',
                "userSelected": true
              },
              {
                "system": 'http://loinc.org',
                "code": '75490-3',
                "userSelected": false
              }
            ],
            "text": 'Radiology Reports'
          },
          "subject": {
            "reference": 'Patient/12724066',
            "display": 'Smart II, Nancy'
          },
          "encounter": {
            "reference": 'Encounter/97953477'
          },
          "effectivePeriod": {
            "end": '2020-08-13T19:36:00.000Z'
          },
          "issued": '2020-08-13T19:36:06Z',
          "performer": [
            {
              "reference": 'Practitioner/12742069',
              "display": 'Portal, Portal'
            }
          ],
          "resultsInterpreter": [
            {
              "reference": 'Practitioner/12742069',
              "display": 'Portal, Portal'
            }
          ],
          "media": [
            {
              "link": {
                "reference": 'Media/drm197369077-InpBMTk3NzA0Njg0QjE5NzcwNDY4OEMi'
              }
            }
          ],
          "presentedForm": [
            {
              "contentType": 'application/pdf',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XR-197369077',
              "title": 'Some Title 4x',
              "creation": '2020-08-13T19:36:00.000Z'
            },
            {
              "contentType": 'application/xml',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XML-197369077',
              "title": 'Some Title 4x',
              "creation": '2020-08-13T19:36:00.000Z'
            },
            {
              "contentType": 'text/html',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/TR-197369077',
              "title": 'Some Title 4x',
              "creation": '2020-08-13T19:36:00.000Z'
            }
          ]
        },
        "search": {
          "mode": 'match'
        }
      },
      {
        "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport/205995338",
        "resource": {
          "resourceType": "DiagnosticReport",
          "id": "205995338",
          "meta": {
            "versionId": "4",
            "lastUpdated": "2023-02-21T20:49:53Z"
          },
          "text": {
            "status": "generated",
            "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Diagnostic Report</b></p><p><b>Document Category</b>: Laboratory</p><p><b>Status</b>: Final</p><p><b>Code</b>: Blood Culture</p><p><b>Effective Date</b>: Feb 21, 2023  1:50 P.M. UTC</p></div>"
          },
          "identifier": [
            {
              "system": "https://fhir.cerner.com/ceuuid",
              "value": "CE87caf4b7-9397-4667-9897-702218017c9e-205995338-2023022120434100"
            }
          ],
          "basedOn": [
            {
              "reference": "ServiceRequest/378475797"
            }
          ],
          "status": "final",
          "category": [
            {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0074",
                  "code": "LAB",
                  "display": "Laboratory",
                  "userSelected": false
                }
              ],
              "text": "Laboratory"
            },
            {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0074",
                  "code": "MB",
                  "display": "Microbiology",
                  "userSelected": false
                }
              ],
              "text": "Microbiology"
            }
          ],
          "code": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/72",
                "code": "21647436",
                "display": "Blood Culture",
                "userSelected": true
              },
              {
                "system": "http://loinc.org",
                "code": "600-7",
                "userSelected": false
              }
            ],
            "text": "Blood Culture"
          },
          "subject": {
            "reference": 'Patient/12724066',
            "display": 'Smart II, Nancy'
          },
          "encounter": {
            "reference": "Encounter/97970192"
          },
          "effectiveDateTime": "2023-02-21T13:50:00Z",
          "issued": "2023-02-21T20:49:53Z",
          "performer": [
            {
              "extension": [
                {
                  "valueCodeableConcept": {
                    "coding": [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0912",
                        "code": "OP",
                        "display": "Ordering Provider"
                      }
                    ],
                    "text": "Ordering Provider"
                  },
                  "url": "http://hl7.org/fhir/StructureDefinition/event-performerFunction"
                }
              ],
              "reference": "Practitioner/11460104"
            },
            {
              "extension": [
                {
                  "valueCodeableConcept": {
                    "coding": [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                        "code": "LA",
                        "display": "legal authenticator"
                      }
                    ],
                    "text": "legal authenticator"
                  },
                  "url": "http://hl7.org/fhir/StructureDefinition/event-performerFunction"
                }
              ],
              "reference": "Practitioner/11786060"
            }
          ],
          "resultsInterpreter": [
            {
              "reference": "Practitioner/11786060"
            }
          ],
          "specimen": [
            {
              "reference": "Specimen/275745679"
            }
          ],
          "result": [
            {
              "reference": "Observation/MIC-CE-205995342",
              "display": "Final"
            },
            {
              "reference": "Observation/MIC-CE-205995340",
              "display": "Pre"
            },
            {
              "reference": "Observation/MIC-CE-ORG-PNL-205995338-1",
              "display": "Klebsiella pneumoniae ESBL"
            }
          ],
          "conclusionCode": [
            {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/52",
                  "code": "213",
                  "display": "NEG",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
                  "code": "NEG",
                  "display": "Negative",
                  "userSelected": false
                }
              ],
              "text": "Negative"
            }
          ]
        },
        "search": {
          "mode": "match"
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-with-_revinclude Response

Example search by _id using _revinclude.
Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?_id=196151517,198381928&_revinclude=Provenance:target
Example Response:
{
    "resourceType": 'Bundle',
    "id": 'b40dab9d-354b-4f8c-b5d4-f47e89a1fc6a',
    "type": 'searchset',
    "link": [
      {
        "relation": 'self',
        "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport?_id=196151517%2C198381928&_revinclude=Provenance%3Atarget'
      }
    ],
    "entry": [
      {
        "fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport/196151517',
        "resource": {
          "resourceType": 'DiagnosticReport',
          "id": '196151517',
          "meta": {
            "versionId": '3',
            "lastUpdated": '2017-01-06T20:09:17.000+00:00'
          },
          "text": {
            "status": 'generated',
            "div": '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Diagnostic Report</b></p><p><b>Patient</b>: RADIOLOGY, TESTTWO</p><p><b>Document Category</b>: Unknown</p><p><b>Document Title</b>: MG Mammo Digital Diagnostic Bilat</p><p><b>Status</b>: Final</p><p><b>Code</b>: MG Mammo Digital Diagnostic Bilat</p><p><b>Effective Date</b>: Jan  6, 2017  7:59 P.M. UTC</p></div>'
          },
          "identifier": [
            {
              "system": 'https://fhir.cerner.com/ceuuid',
              "value": 'CE87caf4b7-9397-4667-9897-702218017c9e-196151517-2017010620084300'
            },
            {
              "system": 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/acsn',
              "value": '00000MG20170000004'
            }
          ],
          "basedOn": [
            {
              "reference": 'ServiceRequest/294749597'
            }
          ],
          "status": 'final',
          "category": [
            {
              "coding": [
                {
                  "system": 'http://terminology.hl7.org/CodeSystem/data-absent-reason',
                  "code": 'unknown',
                  "display": 'Unknown'
                }
              ],
              "text": 'Unknown'
            }
          ],
          "code": {
            "coding": [
              {
                "system": 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/72',
                "code": '21660139',
                "display": 'MG Mammo Digital Diagnostic Bilat',
                "userSelected": true
              },
              {
                "system": 'http://loinc.org',
                "code": '26346-7'
              }
            ],
            "text": 'MG Mammo Digital Diagnostic Bilat'
          },
          "subject": {
            "reference": 'Patient/12458002',
            "display": 'RADIOLOGY, TESTTWO'
          },
          "encounter": {
            "reference": 'Encounter/97697440'
          },
          "effectiveDateTime": '2017-01-06T19:59:20Z',
          "issued": '2017-01-06T20:09:17Z',
          "performer": [
            {
              "reference": 'Practitioner/11648064',
              "display": 'Model, User 437 Cerner'
            }
          ],
          "resultsInterpreter": [
            {
              "reference": 'Practitioner/11648064',
              "display": 'Model, User 437 Cerner'
            }
          ],
          "media": [
            {
              "link": {
                "reference": 'Media/drm196151517-InpBMTk3NzA0Njg0QjE5NzcwNDY4OEMi'
              }
            }
          ],
          "presentedForm": [
            {
              "contentType": 'application/pdf',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XR-196151517',
              "title": 'MG Mammo Digital Diagnostic Bilat',
              "creation": '2017-01-06T20:09:17Z'
            },
            {
              "contentType": 'application/xml',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/R-196151517',
              "title": 'MG Mammo Digital Diagnostic Bilat',
              "creation": '2017-01-06T20:09:17Z'
            }
          ]
        },
        "search": {
          "mode": 'match'
        }
      },
      {
        "fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DiagnosticReport/198381928',
        "resource": {
          "resourceType": 'DiagnosticReport',
          "id": '198381928',
          "meta": {
            "versionId": '1',
            "lastUpdated": '2022-07-07T09:44:40.000Z'
          },
          "text": {
            "status": 'generated',
            "div": '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Diagnostic Report</b></p><p><b>Patient</b>: GETEST, PatientOneHundredSeventyOne</p><p><b>Document Title</b>:test1</p><p><b>Status</b>: Final</p><p><b>Code</b>: Waveform Strip</p><p><b>Effective Start Date</b>:Jul  7, 2022  9:44 A.M. UTC</p><p><b>Effective End Date</b>: Jul  7, 2022  9:44 A.M.UTC</p><p><b>Verifying Provider</b>: Model, User 212 Cerner</p></div>'
          },
          "identifier": [
            {
              "system": 'https://fhir.cerner.com/ceuuid',
              "value": 'CE87caf4b7-9397-4667-9897-702218017c9e-198381928-2022070709444100'
            }
          ],
          "status": 'final',
          "category": [
            {
              "coding": [
                {
                  "system": 'http://loinc.org',
                  "code": '8716-3',
                  "userSelected": false
                }
              ]
            }
          ],
          "code": {
            "coding": [
              {
                "system": 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/72',
                "code": '2574499721',
                "display": 'Waveform Strip',
                "userSelected": true
              }
            ],
            "text": 'Waveform Strip'
          },
          "subject": {
            "reference": 'Patient/12769858',
            "display": 'GETEST, PatientOneHundredSeventyOne'
          },
          "encounter": {
            "reference": 'Encounter/97966187'
          },
          "effectivePeriod": {
            "start": '2022-07-07T09:44:40.000Z',
            "end": '2022-07-07T09:44:40.000Z'
          },
          "issued": '2022-07-07T09:44:40Z',
          "performer": [
            {
              "reference": 'Practitioner/11638486',
              "display": 'Model, User 212 Cerner'
            }
          ],
          "resultsInterpreter": [
            {
              "reference": 'Practitioner/11638486',
              "display": 'Model, User 212 Cerner'
            }
          ],
          "media": [
            {
              "link": {
                "reference": 'Media/drm198381928-InpBMjM3NTIzNzgwQjIzNzUyMzc5MkMi'
              }
            }
          ],
          "presentedForm": [
            {
              "contentType": 'application/pdf',
              "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XR-198381928',
              "title": 'test1',
              "creation": '2022-07-07T09:44:40.000Z'
            }
          ]
        },
        "search": {
          "mode": 'match'
        }
      },
      {
        "fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/INT.doc-198381928',
        "resource": {
          "resourceType": 'Provenance',
          "id": 'INT.doc-198381928',
          "meta": {
            "versionId": '198381928',
            "lastUpdated": '2022-07-07T09:44:40Z'
          },
          "text": {
            "status": 'generated',
            "div": '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>DiagnosticReport/198381928</li></ul><p><b>Recorded</b>: Jul  7, 2022  9:44 A.M. UTC</p><p><b>Agents</b>:</p><dl><dt>Model, User 212 Cerner</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>'
          },
          "target": [
            {
              "reference": 'DiagnosticReport/198381928'
            }
          ],
          "recorded": '2022-07-07T09:44:40Z',
          "agent": [
            {
              "type": {
                "coding": [
                  {
                    "system": 'http://terminology.hl7.org/CodeSystem/provenance-participant-type',
                    "code": 'author'
                  }
                ],
                "text": 'Author'
              },
              "role": [
                {
                  "coding": [
                    {
                      "system": 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
                      "code": 'SOURCE'
                    }
                  ],
                  "text": 'Source'
                }
              ],
              "who": {
                "reference": 'Practitioner/11638486',
                "display": 'Model, User 212 Cerner'
              }
            }
          ]
        },
        "search": {
          "mode": 'include'
        }
      },
      {
        "fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/INT.doc-196151517',
        "resource": {
          "resourceType": 'Provenance',
          "id": 'INT.doc-196151517',
          "meta": {
            "versionId": '196151517',
            "lastUpdated": '2017-01-06T20:09:17Z'
          },
          "text": {
            "status": 'generated',
            "div": '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>DiagnosticReport/196151517</li></ul><p><b>Recorded</b>: Jan  6, 2017  8:09 P.M. UTC</p><p><b>Agents</b>:</p><dl><dt>Model, User 437 Cerner</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>Model Hospital</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>'
          },
          "target": [
            {
              "reference": 'DiagnosticReport/196151517'
            }
          ],
          "recorded": '2017-01-06T20:09:17Z',
          "agent": [
            {
              "type": {
                "coding": [
                  {
                    "system": 'http://terminology.hl7.org/CodeSystem/provenance-participant-type',
                    "code": 'author'
                  }
                ],
                "text": 'Author'
              },
              "role": [
                {
                  "coding": [
                    {
                      "system": 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
                      "code": 'SOURCE'
                    }
                  ],
                  "text": 'Source'
                }
              ],
              "who": {
                "reference": 'Practitioner/11648064',
                "display": 'Model, User 437 Cerner'
              }
            },
            {
              "type": {
                "coding": [
                  {
                    "system": 'http://terminology.hl7.org/CodeSystem/provenance-participant-type',
                    "code": 'author'
                  }
                ],
                "text": 'Author'
              },
              "role": [
                {
                  "coding": [
                    {
                      "system": 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
                      "code": 'SOURCE'
                    }
                  ],
                  "text": 'Source'
                }
              ],
              "who": {
                "reference": 'Organization/675844',
                "display": 'Model Hospital'
              }
            }
          ]
        },
        "search": {
          "mode": 'include'
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.
Back to Top