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)
- 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.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.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12724066
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
"type": "searchset",
"total": 3,
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12724066"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
"resource": {
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
"resource": {
"resourceType": "Condition",
"id": "d2572382197",
"meta": {
"versionId": "2572382197",
"lastUpdated": "2020-06-11T04:03:21.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Diagnosis</b>: Anemia, Anemia (disorder)</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 10, 2020 5:00 P.M. UTC</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"encounter": {
"reference": "Encounter/97953477"
},
"dateRecorded": "2020-06-11",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "271737000",
"display": "Anemia (disorder)",
"userSelected": true
},
{
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "D64.9",
"display": "Anemia, unspecified",
"userSelected": false
}
],
"text": "Anemia"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2020-06-10T17:00:00.000Z"
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203",
"resource": {
"resourceType": "Condition",
"id": "p73077203",
"meta": {
"versionId": "73079095",
"lastUpdated": "2020-04-05T04:00:46.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Clinical Status</b>: Resolved</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 12, 2019</p><p><b>Resolved</b>: Apr 4, 2020 5:00 P.M. UTC</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"dateRecorded": "2020-03-05",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "77386006",
"display": "Patient currently pregnant (finding)",
"userSelected": true
}
],
"text": "Pregnant"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "problem",
"display": "Problem"
}
],
"text": "Problem"
},
"clinicalStatus": "resolved",
"verificationStatus": "confirmed",
"onsetDateTime": "2019-06-12",
"abatementDateTime": "2020-04-04T17:00:00.000Z"
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
"resource": {
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
"resource": {
"resourceType": "Condition",
"id": "00a5d6eb-c567-42f7-be07-53804cece075",
"meta": {
"versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
"lastUpdated": "2020-07-06T19:36:23.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul 6, 2020</p><p><b>Resolved</b>: False</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"dateRecorded": "2020-07-06",
"code": {
"text": "Afraid my community will not be as close with COVID19."
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2020-07-06",
"abatementBoolean": false,
"notes": "Concerns with impact of COVID19 on community."
}
}
}
]
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Example Read by Ids
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=d2572382197,p73077203,00a5d6eb-c567-42f7-be07-53804cece075
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
"type": "searchset",
"total": 3,
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=d2572382197,p73077203,00a5d6eb-c567-42f7-be07-53804cece075"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
"resource": {
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
"resource": {
"resourceType": "Condition",
"id": "d2572382197",
"meta": {
"versionId": "2572382197",
"lastUpdated": "2020-06-11T04:03:21.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Diagnosis</b>: Anemia, Anemia (disorder)</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 10, 2020 5:00 P.M. UTC</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"encounter": {
"reference": "Encounter/97953477"
},
"dateRecorded": "2020-06-11",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "271737000",
"display": "Anemia (disorder)",
"userSelected": true
},
{
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "D64.9",
"display": "Anemia, unspecified",
"userSelected": false
}
],
"text": "Anemia"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2020-06-10T17:00:00.000Z"
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203",
"resource": {
"resourceType": "Condition",
"id": "p73077203",
"meta": {
"versionId": "73079095",
"lastUpdated": "2020-04-05T04:00:46.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Clinical Status</b>: Resolved</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 12, 2019</p><p><b>Resolved</b>: Apr 4, 2020 5:00 P.M. UTC</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"dateRecorded": "2020-03-05",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "77386006",
"display": "Patient currently pregnant (finding)",
"userSelected": true
}
],
"text": "Pregnant"
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "problem",
"display": "Problem"
}
],
"text": "Problem"
},
"clinicalStatus": "resolved",
"verificationStatus": "confirmed",
"onsetDateTime": "2019-06-12",
"abatementDateTime": "2020-04-04T17:00:00.000Z"
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
"resource": {
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
"resource": {
"resourceType": "Condition",
"id": "00a5d6eb-c567-42f7-be07-53804cece075",
"meta": {
"versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
"lastUpdated": "2020-07-06T19:36:23.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul 6, 2020</p><p><b>Resolved</b>: False</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"dateRecorded": "2020-07-06",
"code": {
"text": "Afraid my community will not be as close with COVID19."
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2020-07-06",
"abatementBoolean": false,
"notes": "Concerns with impact of COVID19 on community."
}
}
}
]
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
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.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075
Response
Status: 200 OK
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
"resource": {
"resourceType": "Condition",
"id": "00a5d6eb-c567-42f7-be07-53804cece075",
"meta": {
"versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
"lastUpdated": "2020-07-06T19:36:23.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul 6, 2020</p><p><b>Resolved</b>: False</p></div>"
},
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"dateRecorded": "2020-07-06",
"code": {
"text": "Afraid my community will not be as close with COVID19."
},
"category": {
"coding": [
{
"system": "http://argonaut.hl7.org",
"code": "health-concern",
"display": "Health Concern"
}
],
"text": "Health Concern"
},
"clinicalStatus": "active",
"verificationStatus": "confirmed",
"onsetDateTime": "2020-07-06",
"abatementBoolean": false,
"notes": "Concerns with impact of COVID19 on community."
}
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.
Create
Create a new condition.
POST /Condition
Implementation Notes
- The following restrictions are in place based on
Condition.category
:- For Conditions with a category code of diagnosis:
-
Condition.encounter
is required. -
Condition.abatementDateTime
is not supported.
-
- For Conditions with a category code of problem:
- If
Condition.dateRecorded
is set on the request body, its value will currently be ignored.
- If
- Creating Conditions with a category code of health-concern is not currently supported.
- For Conditions with a category code of diagnosis:
- The code.coding field can have at most 2 codings.
- One of the codings must have userSelected: true
- The other coding must have userSelected: false
- A Condition with a category code of diagnosis will be automatically prioritized to the least significant priority by the Cerner Millennium EHR.
Authorization Types
Headers
Authorization: <OAuth2 Bearer Token>
Accept: application/json+fhir
Content-Type: application/json+fhir
Body fields
Name | Required | Type | |
---|---|---|---|
resourceType
|
Yes |
string |
|
|
|||
patient
|
Yes |
Reference (Patient ) |
|
|
|||
encounter
|
No |
Reference (Encounter ) |
|
|
|||
code
|
Yes |
CodeableConcept |
|
|
|||
category
|
No |
CodeableConcept |
|
|
|||
clinicalStatus
|
No |
code |
|
|
|||
verificationStatus
|
Yes |
code |
|
|
|||
severity
|
No |
CodeableConcept |
|
|
|||
onsetDateTime
|
No |
dateTime |
|
|
|||
abatementBoolean
|
No |
boolean |
|
|
|||
abatementDateTime
|
No |
dateTime |
|
|
|||
notes
|
No |
string |
|
|
Create Problem Example
Request
POST https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition
Body
{
"resourceType": "Condition",
"patient": {
"reference": "Patient/12724066"
},
"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 X-Xss-Protection: 1; mode=block Pragma: no-cache X-Request-Id: 78a19072002b8651623351cfedaffe70 Etag: W/"6809861" X-Frame-Options: SAMEORIGIN 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-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p6809861 Content-Length: 0 Content-Type: application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Create Diagnosis Example
Request
POST https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition
Body
{
"resourceType": "Condition",
"patient": {
"reference": "Patient/12724066"
},
"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/97953477"
}
}
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 X-Xss-Protection: 1; mode=block Pragma: no-cache X-Request-Id: 1b0d589dde95bcafcefd3a1965b5cadf Etag: W/"36474555" X-Frame-Options: SAMEORIGIN 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-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d36474555 Content-Length: 0 Content-Type: application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
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. - The code.coding field can have at most 2 codings, one of which must be set as userSelected true and the other one must be set as userSelected false.
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 | Type | |
---|---|---|---|
resourceType
|
Yes |
string |
|
|
|||
id
|
Yes |
id |
|
|
|||
patient
|
Yes |
Reference (Patient ) |
|
|
|||
encounter
|
No |
Reference (Encounter ) |
|
|
|||
dateRecorded
|
No |
date |
|
|
|||
code
|
Yes |
CodeableConcept |
|
|
|||
category
|
No |
CodeableConcept |
|
|
|||
clinicalStatus
|
No |
code |
|
|
|||
verificationStatus
|
Yes |
code |
|
|
|||
severity
|
No |
CodeableConcept |
|
|
|||
onsetDateTime
|
No |
dateTime |
|
|
|||
abatementBoolean
|
No |
boolean |
|
|
|||
abatementDateTime
|
No |
dateTime |
|
|
|||
notes
|
No |
string |
|
|
Example
Request
PUT https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197
Body
{
"resourceType": "Condition",
"id": "d2572382197",
"meta": {
"versionId": "2572382197",
"lastUpdated": "2020-06-11T04:03:21.000Z"
},
"patient": {
"reference": "Patient/12724066"
},
"encounter": {
"reference": "Encounter/97953477"
},
"dateRecorded": "2020-06-11",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "271737000",
"display": "Anemia (disorder)",
"userSelected": true
},
{
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "D64.9",
"display": "Anemia, unspecified",
"userSelected": false
}
],
"text": "Anemia"
},
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/condition-category",
"code": "diagnosis",
"display": "Diagnosis"
}
],
"text": "Diagnosis"
},
"clinicalStatus": "resolved",
"verificationStatus": "differential",
"onsetDateTime": "2020-06-10T17:00:00.000Z"
}
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 X-Xss-Protection: 1; mode=block Pragma: no-cache X-Request-Id: c58a2925586fa64a89568b9ceac14475 Etag: W/"43538555" X-Frame-Options: SAMEORIGIN X-Content-Type-Options: nosniff Expires: Mon, 01 Jan 1990 00:00:00 GMT Last-Modified: Wed, 01 Mar 2017 15:42:52 GMT Content-Length: 0 Content-Type: application/json
The ETag
response header indicates the current If-Match
version to use on subsequent updates.
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.