Retrieve a patient's diagnostic results

You can use this API action to access the findings or interpretations of a diagnostic procedure—as documented by a specific organization. Typically, you can use this for:

  • tracking the completion of a diagnostic procedure for a patient; 
  • reviewing documents with a provider’s interpretation of a diagnostic procedure (e.g., interpretation of an MRI);
  • enabling users to access one or more result documents on a mobile app;
  • reviewing interpretation results of a diagnostic procedure for billing or coding purposes.  
  • reviewing laboratory data or imaging results; or 
  • recommending a course of treatment based on test results.

The returned data fields may be free text or discrete data/images.

Supported systems

You can use this API action with the Redox FHIR® API.

Your connection's system can return results with their own FHIR® or query-based API. 

Things you need to know

Action steps

Prerequisites

The following actions must be completed before attempting the steps below.

Steps
  • 1
    Retrieve a patient’s diagnostic report
    optional

This table has notes about how to use parameters for this API action specifically, but it's not exhaustive. Refer to the DiagnosticReport resource schema for more details.

Query parameter
Required
Notes
patient.identifier
Y
You must include at least one identifier for the patient that's used by the EHR system you're querying.
encounter
N
If the diagnostic report is the result of a patient visit, then you can include the encounter ID to locate the correct document.
order
N
If the diagnostic report is the result of an order, then you can include the order ID to locate the correct document.
date
N
This is the date and time of diagnostic report.
resultsInterpreter
N
This is the provider or healthcare organization that offered commentary or explanation for the patient's diagnostic results. This may be a different organization than the one that produced the diagnostic test(s) and result(s).

Your search returns a list of potential matches with attachments or references to additional resources.

Query Response
curl 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/DiagnosticReport/_search' \
--request POST \
--header 'Authorization: Bearer ${API_TOKEN}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'subject=Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7'
{
"id": "f64603c1-ee7c-4eff-8759-9e707d93d12a",
"type": "searchset",
"entry": [
{
"search": {
"mode": "match",
"score": 1
},
"resource": {
"id": "27894d07-e072-4969-ab7c-12f175be32c2",
"code": {
"text": "First trimester maternal screen with nuchal translucency panel",
"coding": [
{
"code": "49086-2"
}
]
},
"meta": {
"lastUpdated": "2022-10-03T20:10:27.555Z"
},
"issued": "2015-05-06T06:00:58.872Z",
"result": [
{
"reference": "Observation/649503a3-dcce-43be-9bb8-482e56d0a166"
},
{
"reference": "Observation/3673e6ea-d644-4bf8-ae8e-0d7072fb65fd"
}
],
"status": "final",
"subject": {
"reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"
},
"category": {
"coding": [
{
"code": "LAB",
"system": "http://hl7.org/fhir/v2/0074"
}
]
},
"identifier": [
{
"value": "157968301",
"system": "urn:redox:redox-fhir-sandbox:OrderID",
"extension": [
{
"url": "https://fhir.redoxengine.com/StructureDefinition/identifier-origin",
"valueString": "RedoxAPI"
}
]
}
],
"resourceType": "DiagnosticReport",
"effectiveDateTime": "2015-05-06T06:00:58.872Z"
}
}
],
"total": 1,
"resourceType": "Bundle"
}