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 tests.
Required or some important fields and parameters would be given in the following tables. Operations and parameters of this resource would also be listed.
Resource Element Fields
| Name | Description | Type |
|---|---|---|
| identifier | The identifier for the diagnostic report | Identifier |
| status | The status code | code (DiagnosticReportStatus) |
| category | Service category of this diagnostic report | CodeableConcept (Diagnostic Service Section Codes) |
| code | Name/Code for this diagnostic report | CodeableConcept (LOINC Diagnostic Report Codes) |
| subject | The subject of the report - usually, but not always, the patient | Reference (Patient | Group | Device | Location) |
| context | Health care event when test ordered | Reference (Encounter | EpisodeOfCare) |
| effective | Clinically relevant time/time-period for report | effectiveDateTime: dateTime, effectivePeriod: Period |
| issued | DateTime this version was released | instant |
| performer (BackboneElement) | Participants in producing the report |
role: CodeableConcept (Procedure Performer Role Codes) actor: Reference (Practitioner | Organization ) |
Get Laboratory Tests by Patient
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient={id}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=232
Search Laboatory Tests With Specific Date
For this resource, users are able to search using parameters like date, patient, and category etc. Important searching parameters would be listed in the following table.
| Parameter Name | Description | Type | Required |
|---|---|---|---|
| _id | The Id of the certain resource | string | False |
| identifier | The unique identifier for this report | string | False |
| 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) |
| category | Service category | string | False |
| code | Name/Code for this diagnostic report | string | False |
| status | The status of the report | string | False |
This following request format indicates how to get Laboratory Tests on a specific date, using parameter date.
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient={id}&date={dateTime}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=452&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}&date=>={dateTime}&date=<{dateTime (later than previous dateTime)}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?patient=452&date=>=2015-03-22&date=<2015-12-31
{
"resourceType": "Bundle",
"id": "125abd53-cd23-435e-ba5c-af4c77e925cb",
"meta": {
"lastUpdated": "2017-12-22T11:37:20.438-06:00"
},
"type": "searchset",
"total": 9,
"link": [
{
"relation": "self",
"url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport?date=%3E%3D2015-03-22&date=%3C2015-12-31&patient=452"
}
],
"entry": [
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/519",
"resource": {
"resourceType": "DiagnosticReport",
"id": "519",
"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\"> Urinanalysis macro (dipstick) panel </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>REGISTERED</td></tr></tbody></table></div>"
},
"status": "registered",
"code": {
"coding": [
{
"system": "LOINC",
"code": "24357-6",
"display": "Urinanalysis macro (dipstick) panel"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-29T00:00:00-04:00"
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/DiagnosticReport/518",
"resource": {
"resourceType": "DiagnosticReport",
"id": "518",
"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\"> Urinanalysis macro (dipstick) panel </div><table class=\"hapiPropertyTable\"><tbody><tr><td>Status</td><td>REGISTERED</td></tr></tbody></table></div>"
},
"status": "registered",
"code": {
"coding": [
{
"system": "LOINC",
"code": "24357-6",
"display": "Urinanalysis macro (dipstick) panel"
}
]
},
"subject": {
"reference": "Patient/452"
},
"context": {
"reference": "Encounter/463"
},
"effectiveDateTime": "2015-06-22T11:00:00-04:00"
},
"search": {
"mode": "match"
}
},
{
"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"
}
}
]
}