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
-
_count: number
The maximum number of results to return. Defaults to
10
and a maximum of100
documents can be returned. -
_id: string
The logical resource ID. This parameter is required if the
patient
parameter is not used.
Example:_id=12345
-
_lastUpdated: string
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
, orlt
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
orgt
prefix and the higher value must have anle
orlt
prefix. - The
_lastUpdated
parameter may not be provided at the same time as thedate
parameter.
_lastUpdated=gt2014-09-24
or_lastUpdated=gt2014-09-24T12:00:00.000Z
- This parameter may be provided up to two times, and must use the
-
_revinclude: string
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
orpatient
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 asuser/Provenance.read
,patient/Provenance.read
, orsystem/Provenance.read
.
_revinclude=Provenance:target
- May be provided once with the
-
category: string
The diagnostic discipline or department that created the report.
Example:
orcategory=http://terminology.hl7.org/CodeSystem/v2-0074|LAB
category=http://loinc.org|LP29684-5
-
code: string
The specific code for describing the report.
Example:code=http://loinc.org|24323-8
-
date: string
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
orlt
andge
orgt
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.
date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z
-
encounter: string
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
.
encounter=1621910
-
patient: string
The subject of the report if a patient. This parameter is required if the
_id
parameter is not used.
Example:patient=67890
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
-
accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
Response
Supported Media Types
- application/json+fhir
Default Response
Example search by
Example Request:
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
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
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
Example Request:
_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
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.