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 problems 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 Problems by Patient
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient={id}&category=http://hl7.org/fhir/condition-category|problem
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient=232&category=http://hl7.org/fhir/condition-category|problem
Search Problems With Specific Date
For this resource, users are able to search using parameters like onset-date, abatement-date, 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 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 the same day date range.
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient={id}&category=http://hl7.org/fhir/condition-category|problem&onset-date=>={dateTime}&onset-date=<{dateTime}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient=232&category=http://hl7.org/fhir/condition-category|problem&onset-date=>=2006-12-31&onset-date=<2007-01-01
Search Problems 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|problem&onset-date=>={dateTime}&onset-date=<{dateTime (later than previous dateTime)}
Example:
GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?patient=232&category=http://hl7.org/fhir/condition-category|problem&onset-date=>=2006-10-31&onset-date=<2007-03-01
{
"resourceType": "Bundle",
"id": "67633366-8bf3-4300-b6e5-bb784b7f4d28",
"meta": {
"lastUpdated": "2017-12-20T13:54:46.130-06:00"
},
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fcondition-category%7Cproblem&onset-date=%3E%3D2006-10-31&onset-date=%3C2007-03-01&patient=232"
}
],
"entry": [
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition/249",
"resource": {
"resourceType": "Condition",
"id": "249",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-15T15:18:36.000-06:00"
},
"clinicalStatus": "resolved",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "problem",
"display": "Problem"
}
]
}
],
"code": {
"coding": [
{
"system": "SNOMED CT",
"code": "238131007",
"display": "Overweight"
}
]
},
"subject": {
"reference": "Patient/232"
},
"context": {
"reference": "Encounter/243"
},
"onsetPeriod": {
"start": "2006-12-31T00:00:00-05:00",
"end": "2007-06-01T00:00:00-04:00"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Condition/246",
"resource": {
"resourceType": "Condition",
"id": "246",
"meta": {
"versionId": "1",
"lastUpdated": "2017-12-15T15:18:36.000-06:00"
},
"clinicalStatus": "active",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "problem",
"display": "Problem"
}
]
}
],
"code": {
"coding": [
{
"system": "SNOMED CT",
"code": "83986005",
"display": "Severe hypothyroidism"
}
]
},
"subject": {
"reference": "Patient/232"
},
"context": {
"reference": "Encounter/243"
},
"onsetPeriod": {
"start": "2006-12-31T00:00:00-05:00"
}
},
"search": {
"mode": "match"
}
}
]
}