In FHIR STU3 standard, DiagnosticReport
resource is describing The findings and interpretation of diagnostic tests performed on patients, groups of patients, devices, and locations, and/or specimens derived from these.
In addition, it will also includes clinical context such as requesting and provider information, and some mix of atomic results, images, textual and coded interpretations, and formatted representation of diagnostic reports.
The DiagnosticReport
resource has information about the diagnostic report itself, and about the subject and, in the case of lab tests, the specimen of the report.
Information in this resource is usually provided by a diagnostic service after the diagnostic procedure has finished. A set of atomic results, text reports, images, and codes would be included inthis resource.
In this case, we would use this specific resource to contain the information accordingly to the CCDS element named laboratory values results, utilizing the result element in this resource.
Required or some important fields and parameters would be given in the following tables. Operations and parameters of this resource would also be listed.
*** CAUTION: Most Fields have already been described in the previous page. Please refer to Laboratory Tests. So they would not be listed in this page to reduce the unnecessary redundancy. In this page, more concentrations would be put on the part, which have not yet been described in the previous part.
Resource Element Fields
Name | Description | Type |
---|---|---|
status | The status code | code (DiagnosticReportStatus) |
result | Observations - simple, or complex nested groups | Reference (Observation) |
conclusion | Clinical Interpretation of test results for report | string |
codedDiagnosis | Codes for the conclusion | CodeableConcept (SNOMED CT Clinical Findings ) |
performer (BackboneElement) | Participants in producing the report |
role: CodeableConcept (Procedure Performer Role Codes) actor: Reference (Practitioner | organization ) |
Get Laboratory Values Results by Patient
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient={id}&status=final&_include=DiagnosticReport:result
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=452&status=final&_include=DiagnosticReport:result
Search Laboatory Tests With Specific Date
For this resource, users are able to search using parameters like status, patient, and _include etc. Important searching parameters would be listed in the following table.
Parameter Name | Description | Type | Required |
---|---|---|---|
_include | Filter resources if they are having a result element, which means they are representing the lab test results | string | True |
status | The status has to be final in order to give this resource the meaning of lab test results | string | True |
date | Clinically relevant time/time-period for report | dateTime | False |
patient | The Id representing the specific patient | integer | True (If the query is concerning a specific patient) |
This following request format indicates how to get Laboratory Values Results on a specific date, using parameter date.
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient={id}&status=final&_include=DiagnosticReport:result&date={dateTime}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=452&status=final&_include=DiagnosticReport:result&date=2015-06-22
Search Laboratory Tests With a Date Range
The request format would be like:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient={id}&status=final&_include=DiagnosticReport:result&date=>={dateTime}&date=<{dateTime (later than previous dateTIme)}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=452&status=final&_include=DiagnosticReport:result&date=>=2015-05-22&date=<2015-07-22
{
"resourceType": "Bundle",
"id": "aaf2e286-1e82-4ea3-b455-905fac2dc74b",
"meta": {
"lastUpdated": "2017-12-22T12:34:01.656-06:00"
},
"type": "searchset",
"total": 7,
"link": [
{
"relation": "self",
"url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?_include=DiagnosticReport%3Aresult&date=%3E%3D2015-05-22&date=%3C2015-07-22&patient=452&status=final"
}
],
"entry": [
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/505",
"resource": {
"resourceType": "DiagnosticReport",
"id": "505",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Ketones[Mass/Volume] in urine by test strip </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5797-6",
"display": "Ketones[Mass/Volume] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/506"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/503",
"resource": {
"resourceType": "DiagnosticReport",
"id": "503",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Glucose[Mass/volumn] in urine by test strip </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5792-7",
"display": "Glucose[Mass/volumn] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/504"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/507",
"resource": {
"resourceType": "DiagnosticReport",
"id": "507",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Protein[Mass/Volume] in urine by test strip </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5804-0",
"display": "Protein[Mass/Volume] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/508"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/501",
"resource": {
"resourceType": "DiagnosticReport",
"id": "501",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> pH of Urine by Test strip </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5803-2",
"display": "pH of Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/502"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/497",
"resource": {
"resourceType": "DiagnosticReport",
"id": "497",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Appearance of Urine </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5767-9",
"display": "Appearance of Urine"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/498"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/495",
"resource": {
"resourceType": "DiagnosticReport",
"id": "495",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Color of Urine </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5778-6",
"display": "Color of Urine"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/496"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/499",
"resource": {
"resourceType": "DiagnosticReport",
"id": "499",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\"> Specific gravity of Urine by Test strip </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>FINAL</td></tr></tbody></table></div>"
},
"status": "final",
"code": {
"coding": [
{
"system": "LOINC",
"code": "5811-5",
"display": "Specific gravity of Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"result": [
{
"reference": "Observation/500"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/496",
"resource": {
"resourceType": "Observation",
"id": "496",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5778-6",
"display": "Color of Urine"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueString": "YELLOW",
"referenceRange": [
{
"text": "YELLOW"
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/498",
"resource": {
"resourceType": "Observation",
"id": "498",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5767-9",
"display": "Appearance of Urine"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueString": "CLEAR",
"referenceRange": [
{
"text": "CLEAR"
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/500",
"resource": {
"resourceType": "Observation",
"id": "500",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5811-5",
"display": "Specific gravity of Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueString": "1.015",
"referenceRange": [
{
"low": {
"value": 1.005
},
"high": {
"value": 1.03
}
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/502",
"resource": {
"resourceType": "Observation",
"id": "502",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5803-2",
"display": "pH of Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueQuantity": {
"value": 5,
"unit": "[pH]"
},
"referenceRange": [
{
"low": {
"value": 5
},
"high": {
"value": 8
}
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/504",
"resource": {
"resourceType": "Observation",
"id": "504",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5792-7",
"display": "Glucose[Mass/volumn] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueQuantity": {
"value": 50,
"unit": "mg/dL"
},
"referenceRange": [
{
"text": "Neg"
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/506",
"resource": {
"resourceType": "Observation",
"id": "506",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5797-6",
"display": "Ketones[Mass/Volume] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueString": "Negative",
"referenceRange": [
{
"text": "Negative"
}
]
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/508",
"resource": {
"resourceType": "Observation",
"id": "508",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-19T10:05:25.000-06:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "LOINC",
"code": "5804-0",
"display": "Protein[Mass/Volume] in urine by test strip"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00",
"valueQuantity": {
"value": 100,
"unit": "mg/dL"
},
"referenceRange": [
{
"text": "negative"
}
]
},
"search": {
"mode": "include"
}
}
]
}