In FHIR STU3 standard, Condition resource is designed as a type of event resource describing, measurements and simple assertions made about a
patient, device or other subject. In this case, this resource is utilized to describe health concerns in this RESTful API.
Using Condition resource is used to record detailed information about a condition, problem, diagnosis, or other event, situation, issue, or clinical concept that has risen to a level of concern.
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 this specific condition resource | Identifier |
| clinicalStatus | The condition status | code (Condition Clinical Status Codes) |
| verificationStatus | The condition verification status | code (ConditionVerificationStatus) |
| category | Category of the condition | CodeableConcept (Condition Category Codes) |
| severity | Subjective severity of condition | CodeableConcept (Condition/Diagnosis Severity) |
| code | Identification of the condition, problem or diagnosis | CodeableConcept (Condition/Problem/Diagnosis Codes Severity) |
| subject | Who and/or what this is about | Reference (Patient | Group) |
| onset | Estimated or actual date, date-time, or age |
onsetDateTime: dateTime onsetAge: Age onsetPeriod: Period onsetRange: Range onsetString: string |
| abatement | If/when in resolution/remission |
abatementDateTime: dateTime abatementAge: Age abatementBoolean: boolean abatementPeriod: Period abatementRange: Range abatementString: string |
Get Health Concerns by Patient
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient={id}&category=http://hl7.org/fhir/condition-category|health-concern
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient=232&category=http://hl7.org/fhir/condition-category|health-concern
Search Health Concerns With Specific Date
For this resource, which is pretty much the same regarding the parameters, because it is also adapting Condition as it's base resource.
| Parameter Name | Description | Type | Required |
|---|---|---|---|
| _id | The Id of the certain resource | string | False |
| identifier | The unique identifier for the condition | string | False |
| onset-date | Estimated or actual date of this condition or problem | dateTime | False |
| abatement-date | Estimated or actual date of this condition or problem is resolved | dateTime | False |
| patient | The Id representing the specific patient | integer | True (If the query is concerning a specific patient) |
| category | The category of this condition, this parameter is used to search specific type of condition Problems, Health Concerns, for example |
string | True (Required searching for Problems, and Health Concerns) |
| code | Identify condition, problem or diagnosis | string | False |
| subject | Who and/or what this is about | string | False |
This following request format indicates how to get condition resources on a specific date, by limiting a range of same day.
GET https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition?patient={id}&category=http://hl7.org/fhir/condition-category|health-concern&onset-date=>={dateTime}&onset-date=<={dateTime}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition?patient=56&category=http://hl7.org/fhir/condition-category|health-concern&onset-date=>=2015-06-22&onset-date=<=2015-06-22
Search Health Concerns With a Date Range
The request format would be like:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition?patient={id}&category=http://hl7.org/fhir/condition-category|health-concern&onset-date=>={dateTime}&onset-date=<={dateTime (later than previous dateTime)}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition?patient=56&category=http://hl7.org/fhir/condition-category|health-concern&onset-date=>=2015-06-22&onset-date=<=2015-06-27
{
"resourceType": "Bundle",
"id": "2256dfc2-1831-4ca4-9714-819acbe5cd58",
"meta": {
"lastUpdated": "2018-02-14T17:59:43.688-06:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fcondition-category%7Chealth-concern&onset-date=%3E%3D2015-06-22&onset-date=%3C%3D2015-06-27&patient=56"
}
],
"entry": [
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3//Condition/118",
"resource": {
"resourceType": "Condition",
"id": "118",
"meta": {
"versionId": "1",
"lastUpdated": "2018-02-14T17:15:14.000-06:00"
},
"text": {
"status": "additional"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "health-concern",
"display": "Health Concern"
}
]
}
],
"code": {
"coding": [
{
"system": "2.16.840.1.113883.6.96",
"code": "161901003",
"display": "Chronically Ill"
}
]
},
"subject": {
"reference": "Patient/56",
"display": "Alice Jones Newman"
},
"onsetDateTime": "2015-06-22T11:00:00-04:00"
},
"search": {
"mode": "match"
}
}
]
}