Condition
Overview
The Condition resource is used to record details about a patient’s problems, diagnoses, or other health matters that are concerning. It is common to capture Conditions during the encounter or visit. This is usually captured both as initial suspected problems and confirmed or refuted problems or diagnoses at the time of discharge. This resource may be referenced by other resources as a “reason” for an action or order such as the reason for ordering a medication or procedure.
This resource is NOT intended to record subjective or objective information that could lead to the recording of a condition such as signs or symptoms. Signs and symptoms are typically documented as Observations although some persistent symptoms such as fever or headache may be documented prior to the definitive diagnosis being recognized by a clinician.
References to implicitRules
and modifierExtension
fields are NOT supported and will fail a Create or Update request.
The following fields are returned if valued:
- Id
- Patient
- Patient encounter when first recorded (only applies to diagnoses)
- Who recorded the condition
- Date recorded
- Condition code
- Status
- Category
- Verification status
- Onset (dateTime)
- Resolved (either boolean or dateTime) (only applies to problems)
- Severity
- Comment/Note
Terminology Bindings
Condition.code |
Condition.category |
|
Condition.clinicalStatus |
|
Condition.severity |
|
Search
Search for Conditions that meet supplied query parameters:
GET /Condition?:parameters
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
This or patient , if populated all other parameters are not allowed |
token |
The logical resource id associated with the resource. Example: p12345
|
patient |
This or _id
|
reference |
The patient who has the condition. Example: 12345
|
category |
N | token |
The category of the condition. Example: diagnosis , problem , health-concern
|
clinicalstatus |
N | token |
The clinical status of the condition. Example: resolved
|
Notes:
- Currently only
diagnosis
,problem
andhealth-concern
category codes are supported.
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition?patient=4342012
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
"type": "searchset",
"total": 3,
"link": [
{
"relation": "self",
"url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition?patient=4342012"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/d35686553",
"resource": {
"resourceType": "Condition",
"id": "d35686553",
"meta": {
"versionId": "35686553",
"lastUpdated": "2016-06-27T19:02:31.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Diagnosis</b>: Ear Infection (Right)</p><p><b>Clinical Status</b>: active</p><p><b>Verification Status</b>: Unknown</p><p><b>Onset</b>: 2016-06-27</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"encounter": {
"reference": "Encounter/4027933"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2016-06-27",
"code": {
"text": "Ear Infection (Right)"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "active",
"verificationStatus": "unknown",
"onsetDateTime": "2016-06-27"
}
},
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/p6317881",
"resource": {
"resourceType": "Condition",
"id": "p6317881",
"meta": {
"versionId": "6317881",
"lastUpdated": "2016-06-27T18:51:27.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Problem</b>: Ear infection</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Resolved</b>: false</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2016-06-27",
"code": {
"text": "Ear infection"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "problem",
"display": "Problem"
}
],
"text": "Problem"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed"
}
},
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/7965c636-f343-4e96-8904-3bc35e9fd9f9",
"resource": {
"resourceType": "Condition",
"id": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"meta": {
"versionId": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"lastUpdated": "2017-01-11T09:09:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Health Concern</b>: Decs</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: 2017-01-11</p><p><b>Resolved</b>: false</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2017-01-11",
"code": {
"text": "Test Health Concern"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2017-01-11",
"abatementBoolean": false
}
}
]
}
Example Read by Ids
Request
GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition?_id=d35686553,p6317881,7965c636-f343-4e96-8904-3bc35e9fd9f9
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
"type": "searchset",
"total": 3,
"link": [
{
"relation": "self",
"url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition?_id=d35686553,p6317881,7965c636-f343-4e96-8904-3bc35e9fd9f9"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/d35686553",
"resource": {
"resourceType": "Condition",
"id": "d35686553",
"meta": {
"versionId": "35686553",
"lastUpdated": "2016-06-27T19:02:31.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Diagnosis</b>: Ear Infection (Right)</p><p><b>Clinical Status</b>: active</p><p><b>Verification Status</b>: Unknown</p><p><b>Onset</b>: 2016-06-27</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"encounter": {
"reference": "Encounter/4027933"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2016-06-27",
"code": {
"text": "Ear Infection (Right)"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "active",
"verificationStatus": "unknown",
"onsetDateTime": "2016-06-27"
}
},
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/p6317881",
"resource": {
"resourceType": "Condition",
"id": "p6317881",
"meta": {
"versionId": "6317881",
"lastUpdated": "2016-06-27T18:51:27.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Problem</b>: Ear infection</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Resolved</b>: false</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2016-06-27",
"code": {
"text": "Ear infection"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "problem",
"display": "Problem"
}
],
"text": "Problem"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed"
}
},
{
"fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/7965c636-f343-4e96-8904-3bc35e9fd9f9",
"resource": {
"resourceType": "Condition",
"id": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"meta": {
"versionId": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"lastUpdated": "2017-01-11T09:09:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Health Concern</b>: Decs</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: 2017-01-11</p><p><b>Resolved</b>: false</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2017-01-11",
"code": {
"text": "Test Health Concern"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2017-01-11",
"abatementBoolean": false
}
}
]
}
Errors
The common errors and OperationOutcomes may be returned.
Retrieve by id
List an individual Condition by its id:
GET /Condition/:id
Authorization Types
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/7965c636-f343-4e96-8904-3bc35e9fd9f9
Response
Status: 200 OK
{
"resourceType": "Condition",
"id": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"meta": {
"versionId": "7965c636-f343-4e96-8904-3bc35e9fd9f9",
"lastUpdated": "2017-01-11T09:09:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: Smart, Timmy</p><p><b>Health Concern</b>: Decs</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: 2017-01-11</p><p><b>Resolved</b>: false</p></div>"
},
"patient": {
"reference": "Patient/4342012",
"display": "Smart, Timmy"
},
"asserter": {
"reference": "Practitioner/1912007",
"display": "Forrest, Fhir"
},
"dateRecorded": "2017-01-11",
"code": {
"text": "Test Health Concern"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2017-01-11",
"abatementBoolean": false
}
Errors
The common errors and OperationOutcomes may be returned.
Create
Create a new condition.
POST /Condition
Implementation Notes
- Currently,
health-concern
category code is not supported for writing conditions.
Authorization Types
Headers
Authorization: <OAuth2 Bearer Token>
Accept: application/json+fhir
Content-Type: application/json+fhir
Body fields
Notes:
-
dateRecorded
is currently not honored on a create for Conditions with a category ofproblem
. -
abatementDateTime
is not supported for Conditions with a category ofdiagnosis
. -
encounter
is required for Conditions with a category ofdiagnosis
.
Name | Required | Cardinality | Type |
---|---|---|---|
resourceType
|
Yes | 1..1 |
string |
|
|||
patient
|
Yes | 1..1 |
Reference (Patient ) |
|
|||
encounter
|
No | 0..1 |
Reference (Encounter ) |
|
|||
asserter
|
No | 0..1 |
Reference (Practitioner ) |
|
|||
code
|
Yes | 1..1 |
CodeableConcept |
|
|||
category
|
No | 0..1 |
CodeableConcept |
|
|||
clinicalStatus
|
No | 0..1 |
code |
|
|||
verificationStatus
|
Yes | 1..1 |
code |
|
|||
severity
|
No | 0..1 |
CodeableConcept |
|
|||
onsetDateTime
|
No | 0..1 |
dateTime |
|
|||
abatementBoolean
|
No | 0..1 |
boolean |
|
|||
abatementDateTime
|
No | 0..1 |
dateTime |
|
|||
notes
|
No | 0..1 |
string |
|
Create Problem Example
Request
POST /Condition
Body
{
"resourceType": "Condition",
"patient": {
"reference": "Patient/1316020"
},
"code": {
"text": "Freetext Condition"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "problem",
"display": "Problem"
}
],
"text": "Problem"
},
"clinicalStatus": "resolved",
"verificationStatus": "differential",
"abatementDateTime": "2017-01-01T00:00:00Z"
}
Response
Status: 201 Created
Date → Tue, 28 Feb 2017 21:26:37 GMT Cache-Control → no-cache Vary → Origin,User-Agent,Accept-Encoding Strict-Transport-Security → max-age=631152000 Server-Response-Time → 9272.410216999999 X-Xss-Protection → 1; mode=block Pragma → no-cache X-Request-Id → 78a19072002b8651623351cfedaffe70 Etag → W/"6809861" X-Frame-Options → SAMEORIGIN X-Runtime → 9.272318 X-Content-Type-Options → nosniff Expires → Mon, 01 Jan 1990 00:00:00 GMT Last-Modified → Tue, 28 Feb 2017 21:26:44 GMT Location → https://fhir-ehr.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/p6809861 Status → 201 Created Content-Length → 0 Content-Type → application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Create Diagnosis Example
Request
POST /Condition
Body
{
"resourceType": "Condition",
"patient": {
"reference": "Patient/1316020"
},
"code": {
"text": "Freetext Diagnosis"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "active",
"verificationStatus": "differential",
"encounter": {
"reference": "Encounter/2457909"
}
}
Response
Status: 201 Created
Date → Tue, 28 Feb 2017 21:30:28 GMT Cache-Control → no-cache Vary → Origin,User-Agent,Accept-Encoding Strict-Transport-Security → max-age=631152000 Server-Response-Time → 767.841864 X-Xss-Protection → 1; mode=block Pragma → no-cache X-Request-Id → 1b0d589dde95bcafcefd3a1965b5cadf Etag → W/"36474555" X-Frame-Options → SAMEORIGIN X-Runtime → 0.767820 X-Content-Type-Options → nosniff Expires → Mon, 01 Jan 1990 00:00:00 GMT Last-Modified → Tue, 28 Feb 2017 21:30:28 GMT Location → https://fhir-ehr.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Condition/d36474555 Status → 201 Created Content-Length → 0 Content-Type → application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Errors
The common errors and OperationOutcomes may be returned.
Update
Update an existing condition.
PUT /Condition/:id
Implementation Notes
- Any field which is missing will be interpreted as nulling out or removing data from the resource. See FHIR® Update for additional details about update operations.
- Currently,
health-concern
category code is not supported for updating conditions.
Authorization Types
Headers
Authorization: <OAuth2 Bearer Token>
Accept: application/json+fhir
Content-Type: application/json+fhir
If-Match: W/"<Current version of the Condition resource>"
Body fields
Notes:
-
abatementDateTime
is not supported for Conditions with a category ofdiagnosis
. -
notes
cannot be added ifnotes
already exists. An existingnotes
field cannot be modified.
Name | Required | Cardinality | Type |
---|---|---|---|
resourceType
|
Yes | 1..1 |
string |
|
|||
id
|
Yes | 0..1 |
id |
|
|||
patient
|
Yes | 1..1 |
Reference (Patient ) |
|
|||
encounter
|
No | 0..1 |
Reference (Encounter ) |
|
|||
asserter
|
No | 0..1 |
Reference (Practitioner ) |
|
|||
dateRecorded
|
No | 0..1 |
date |
|
|||
code
|
Yes | 1..1 |
CodeableConcept |
|
|||
category
|
No | 0..1 |
CodeableConcept |
|
|||
clinicalStatus
|
No | 0..1 |
code |
|
|||
verificationStatus
|
Yes | 1..1 |
code |
|
|||
severity
|
No | 0..1 |
CodeableConcept |
|
|||
onsetDateTime
|
No | 0..1 |
dateTime |
|
|||
abatementBoolean
|
No | 0..1 |
boolean |
|
|||
abatementDateTime
|
No | 0..1 |
dateTime |
|
|||
notes
|
No | 0..1 |
string |
|
Example
Request
PUT /Condition/p6809861
Body
{
"resourceType": "Condition",
"id": "d36474555",
"meta": {
"versionId": "36474555",
"lastUpdated": "2017-02-28T21:30:28.000Z"
},
"patient": {
"reference": "Patient/1316020"
},
"encounter": {
"reference": "Encounter/2457909"
},
"asserter": {
"reference": "Practitioner/1316007"
},
"dateRecorded": "2017-02-28",
"code": {
"text": "Freetext Diagnosis"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "resolved",
"verificationStatus": "differential",
"onsetDateTime": "2017-02-28"
}
Response
Status: 200 OK
Date → Wed, 01 Mar 2017 15:42:52 GMT Cache-Control → no-cache Vary → Origin,User-Agent,Accept-Encoding Strict-Transport-Security → max-age=631152000 Server-Response-Time → 1227.508429 X-Xss-Protection → 1; mode=block Pragma → no-cache X-Request-Id → c58a2925586fa64a89568b9ceac14475 Etag → W/"6809873" X-Frame-Options → SAMEORIGIN X-Runtime → 1.227476 X-Content-Type-Options → nosniff Expires → Mon, 01 Jan 1990 00:00:00 GMT Last-Modified → Wed, 01 Mar 2017 15:42:52 GMT Status → 200 OK Content-Length → 0 Content-Type → application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Errors
The common errors and OperationOutcomes may be returned.