Condition

• Overview
• Terminology Bindings
• Search
  • Authorization Types
  • Parameters
  • Headers
  • Example
  • Example with RevInclude
  • Authorization Types
  • Errors
• Retrieve by id
  • Authorization Types
  • Headers
  • Example
  • Errors
• Create
  • Authorization Types
  • Headers
  • Body Fields
  • Example
  • Errors
• Update
  • Authorization Types
  • Headers
  • Body fields
  • Example
  • Errors

Overview

The Condition resource is used to record problems, diagnoses, or other health matters that are concerning to a patient. Depending on the site, problems and diagnoses are used in different ways. Diagnoses are recorded on an encounter to document conditions addressed or treated during a specific patient visit. For U.S. clients, diagnoses support financial or reimbursement workflows. Problems are on-going or chronic conditions that are managed over every visit and not associated to a specific encounter. A condition may be both a diagnosis and a problem. Conditions, specifically diagnoses, are often associated to orders to document the medical necessity of a specific medication or procedure order and may be referenced by other resources as a “reason” for an action or order. Health concerns are also returned as part of the Condition resource and represent other concerns a patient may have such as financial or social risks.

The following HL7® FHIR® US Core Implementation Guide STU 4.0.0 Profiles are supported by this resource:

• US Core Condition Profile

The following fields are returned if valued:

• Id
• Clinical status
• Verification status
• Category
• Severity
• Condition code
• Subject
  • Reference (Patient)
• Patient encounter when first recorded (only applies to diagnoses)
• Onset
  • dateTime
• Resolved date (only applies to problems and health-concerns)
  • dateTime
• Date recorded
• Who recorded the condition
  • Reference (Practitioner)
• Asserter
  • Reference (Patient | Practitioner)
• Comment/Note
  • Annotation
    • author
      • Reference (Practitioner) | string
    • time (dateTime)
    • text (markdown)

Terminology Bindings

Condition.clinicalStatus

Description The clinical status of the condition. Details: Condition Clinical Status Codes System: http://terminology.hl7.org/CodeSystem/condition-clinical

Condition.verificationStatus

Description The verification status to support or decline the clinical status of the condition or diagnosis. Details: Condition Verification Status Codes System: http://terminology.hl7.org/CodeSystem/condition-ver-status

Condition.category

Description A category assigned to the condition. Note Category codes encounter-diagnosis, problem-list-item and health-concern are supported for search and retrieve functionality. Classification codes Medical, Patient Stated, Nursing and Nutrition are supported for search and retrieve functionality. Details: Condition Category Codes System: http://terminology.hl7.org/CodeSystem/condition-category Details: US Core Condition Category Codes System: http://hl7.org/fhir/us/core/CodeSystem/condition-category Details: Millennium Problem Classification System: https://fhir.cerner.com/<EHR source id>/codeSet/12033

Condition.severity

Description A subjective assessment of the severity of the condition as evaluated by the clinician. Details: SNOMED CT System: http://snomed.info/sct Details: Millennium Condition Severity System: https://fhir.cerner.com/<EHR source id>/codeSet/12022

Condition.code

Description Identification of the condition, problem or diagnosis. Details: SNOMED CT System: http://snomed.info/sct Details: ICD-9-CM System: http://hl7.org/fhir/sid/icd-9-cm Details: ICD-10-CM System: http://hl7.org/fhir/sid/icd-10-cm

Search

Search for Conditions that meet supplied query parameters:

GET /Condition?:parameters

Implementation Notes

• Currently problem-list-item, encounter-diagnosis and health-concern are supported.

Authorization Types

Parameters

Name	Required?	Type	Description
_id	This or patient or subject	token	The logical resource id associated with the resource.
patient	This or _id or subject	reference	Who the condition is for. Example: 12345
subject	This or _id or patient	reference	Who the condition is for. Example: Patient/12345
clinical-status	No	token	The clinical status of the condition. Example: active, inactive, resolved
category	No	token	The category of the condition. Categories problem-list-item, encounter-diagnosis and health-concern are supported as of now. Example: problem-list-item, encounter-diagnosis, health-concern
_revinclude	No	token	Provenance resource entries to be returned as part of the bundle. Example:_revinclude=Provenance:target
encounter	No	reference	The encounter ID/s for the patient. Encounter-diagnosis conditions that match the encounter ID/s and all problem-list-item conditions of the patient are returned. Example: encounter=97733489

Notes:

• If _id is provided, no other parameters may be provided.

• The _revinclude parameter may be provided once with the value Provenance:target. Example: _revinclude=Provenance:target

• The _revinclude parameter may be provided with the _id/patient parameter. Example: _id=82c1c95c-83bb-47d2-86d7-7961aa996082&_revinclude=Provenance:target

• When _revinclude is provided in a request to the closed endpoint, the OAuth2 token must include the user/Provenance.read scope. Currently patient/Provenance.read is not supported and hence _revinclude cannot be utilised for patient persona.

• When encounter is provided, encounter-diagnosis for the matched encounter/s and all problem-list-item conditions of the patient will be returned. No HealthConcerns are returned.

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12724066

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "9a115304-90d2-47d7-98c4-026f7fe1580e",
  "type": "searchset",
  "total": 2,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12724066"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203",
      "resource": {
        "resourceType": "Condition",
        "id": "p73077203",
        "meta": {
          "versionId": "73080185",
          "lastUpdated": "2020-06-11T04:05:04.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Category Classification</b>: Medical</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>"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "resolved",
              "display": "Resolved",
              "userSelected": false
            }
          ],
          "text": "Resolved"
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed",
              "userSelected": false
            }
          ],
          "text": "Confirmed"
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/condition-category",
                "code": "problem-list-item",
                "display": "Problem List Item"
              }
            ],
            "text": "Problem List Item"
          },
          {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "74188005",
                "display": "Medical (qualifier value)",
                "userSelected": false
              }
            ],
            "text": "Medical"
          }
        ],
        "code": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "77386006",
              "display": "Patient currently pregnant (finding)",
              "userSelected": true
            }
          ],
          "text": "Pregnant"
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "onsetDateTime": "2019-06-12",
        "abatementDateTime": "2020-04-04T17:00:00.000Z",
        "recordedDate": "2020-03-05T16:54:50.000Z",
        "recorder": {
          "reference": "Practitioner/683925",
          "display": "Cerner Test, Women's Health - Nurse Cerner"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/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 xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Diagnosis</b>: Anemia, Anemia (disorder)</p><p><b>Category Classification</b>: Medical</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>"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ],
          "text": "Active"
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed",
              "userSelected": false
            }
          ],
          "text": "Confirmed"
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/condition-category",
                "code": "encounter-diagnosis",
                "display": "Encounter Diagnosis"
              }
            ],
            "text": "Encounter Diagnosis"
          },
          {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "74188005",
                "display": "Medical (qualifier value)",
                "userSelected": false
              }
            ],
            "text": "Medical"
          }
        ],
        "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"
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "encounter": {
          "reference": "Encounter/97953477"
        },
        "onsetDateTime": "2020-06-10T17:00:00.000Z",
        "recordedDate": "2020-06-11T04:03:21.000Z",
        "recorder": {
          "reference": "Practitioner/4122630",
          "display": "Cerner Test, Physician - Women's Health Cerner"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/bed1c2ec-1f33-4097-8296-f6aa01824387",
      "resource": {
        "resourceType": "Condition",
        "id": "bed1c2ec-1f33-4097-8296-f6aa01824387",
        "meta": {
          "versionId": "bed1c2ec-1f33-4097-8296-f6aa01824387",
          "lastUpdated": "2020-10-20T20:46:41.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Health Concern</b>: description, description</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Sep 20, 2020</p><p><b>Recorder</b>: DEXLast2020-10-20T20:46:41.123Z_11, DEXFirst2020-10-20T20:46:41.122Z_48</p><p><b>Recorded Date</b>: Oct 13, 2020  3:46 P.M. CDT</p></div>"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ],
          "text": "Active"
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ],
          "text": "Confirmed"
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ],
            "text": "Health Concern"
          }
        ],
        "code": {
          "text": "description"
        },
        "subject": {
          "reference": "Patient/9279171"
        },
        "onsetDateTime": "2020-09-20",
        "recordedDate": "2020-10-13T20:46:40.000Z",
        "recorder": {
          "reference": "Practitioner/9279172",
          "display": "DEXLast2020-10-20T20:46:41.123Z_11, DEXFirst2020-10-20T20:46:41.122Z_48"
        },
        "note": [
          {
            "time": "2020-10-20T20:46:41.000Z",
            "text": "comments"
          }
        ]
      }
    }
  ]
}

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 with RevInclude

Authorization Types

Request

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=00a5d6eb-c567-42f7-be07-53804cece075&_revinclude=Provenance:target

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "27541846-3943-4168-8ccf-fc5dff9cdac3",
  "type": "searchset",
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=00a5d6eb-c567-42f7-be07-53804cece075&_revinclude=Provenance%3Atarget"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/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 xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCYU</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>Recorder</b>: Spence, Stephen</p><p><b>Recorded Date</b>: Jul  6, 2020  7:36 P.M. UTC</p><p><b>Asserter</b>: SMART, NANCYU</p></div>"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ],
          "text": "Active"
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ],
          "text": "Confirmed"
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ],
            "text": "Health Concern"
          }
        ],
        "code": {
          "text": "Afraid my community will not be as close with COVID19."
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCYU"
        },
        "onsetDateTime": "2020-07-06",
        "recordedDate": "2020-07-06T19:36:23.000Z",
        "recorder": {
          "reference": "Practitioner/12724064",
          "display": "Spence, Stephen"
        },
        "asserter": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCYU"
        },
        "note": [
          {
            "time": "2020-07-06T19:36:23.000Z",
            "text": "Concerns with impact of COVID19 on community."
          }
        ]
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/INT.hcncrn-00a5d6eb-c567-42f7-be07-53804cece075",
      "resource": {
        "resourceType": "Provenance",
        "id": "INT.hcncrn-00a5d6eb-c567-42f7-be07-53804cece075",
        "meta": {
          "versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
          "lastUpdated": "2020-07-06T19:36:23Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Condition/00a5d6eb-c567-42f7-be07-53804cece075</li></ul><p><b>RecordedSpence, Open Platform IA, Stephen</b>: Jul  6, 2020  7:36 P.M. UTC</p><p><b>Agents</b>:</p><dl><dt></dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
        },
        "target": [
          {
            "reference": "Condition/00a5d6eb-c567-42f7-be07-53804cece075"
          }
        ],
        "recorded": "2020-07-06T19:36:23Z",
        "agent": [
          {
            "type": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                  "code": "author"
                }
              ],
              "text": "Author"
            },
            "role": [
              {
                "coding": [
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                    "code": "SOURCE"
                  }
                ],
                "text": "Source"
              }
            ],
            "who": {
              "reference": "Practitioner/12724064",
              "display": "Spence, Open Platform IA, Stephen"
            }
          }
        ]
      },
      "search": {
        "mode": "include"
      }
    }
  ]
}

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.

Patient Authorization Request

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12742400

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "9a115304-90d2-47d7-98c4-026f7fe1580e",
  "type": "searchset",
  "total": 2,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12742400"
    }
  ],
  "entry": [
    {
      "resourceType": "Condition",
      "id": "p109117485",
      "meta": {
        "versionId": "109117485",
        "lastUpdated": "2020-06-11T04:05:04.000Z"
      },
      "text": {
        "status": "generated",
        "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Category Classification</b>: Medical</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>"
      },
      "clinicalStatus": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
            "code": "resolved",
            "display": "Resolved",
            "userSelected": false
          }
        ],
        "text": "Resolved"
      },
      "verificationStatus": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
            "code": "confirmed",
            "display": "Confirmed",
            "userSelected": false
          }
        ],
        "text": "Confirmed"
      },
      "category": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-category",
              "code": "problem-list-item",
              "display": "Problem List Item"
            }
          ],
          "text": "Problem List Item"
        },
        {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "74188005",
              "display": "Medical (qualifier value)",
              "userSelected": false
            }
          ],
          "text": "Medical"
        }
      ],
      "code": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "77386006",
            "display": "Patient currently pregnant (finding)",
            "userSelected": true
          }
        ],
        "text": "Pregnant"
      },
      "subject": {
        "reference": "Patient/12742400",
        "display": "SMART, NANCY"
      },
      "onsetDateTime": "2019-06-12",
      "abatementDateTime": "2020-04-04T17:00:00.000Z",
      "recordedDate": "2020-03-05T16:54:50.000Z"
    },
    {
      "resourceType": "Condition",
      "id": "d2266495305",
      "meta": {
        "versionId": "2266495305"
      },
      "text": {
        "status": "generated",
        "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Diagnosis</b>: Error, Error</p><p><b>Category Classification</b>: Medical</p><p><b>Verification Status</b>: Entered in Error</p></div>"
      },
      "verificationStatus": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
            "code": "entered-in-error",
            "display": "Entered in Error"
          }
        ],
        "text": "Entered in Error"
      },
      "category": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-category",
              "code": "encounter-diagnosis",
              "display": "Encounter Diagnosis"
            }
          ],
          "text": "Encounter Diagnosis"
        },
        {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "74188005",
              "display": "Medical (qualifier value)",
              "userSelected": false
            }
          ],
          "text": "Medical"
        }
      ],
      "code": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/data-absent-reason",
            "code": "error",
            "display": "Error"
          }
        ],
        "text": "Error"
      },
      "subject": {
        "reference": "Patient/12742400"
      }
    },
    {
      "resourceType": "Condition",
      "id": "a077dc30-8eee-4bb7-ae7f-ced1273f5c68",
      "meta": {
        "versionId": "a077dc30-8eee-4bb7-ae7f-ced1273f5c68",
        "lastUpdated": "2020-12-03T22:47:30.000Z"
      },
      "text": {
        "status": "generated",
        "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, TIMMY</p><p><b>Health Concern</b>: THIS IS A TEST GOAL, THIS IS A TEST GOAL</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Dec  3, 2020</p><p><b>Recorded Date</b>: Dec  3, 2020 10:47 P.M. UTC</p></div>"
      },
      "clinicalStatus": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
            "code": "active",
            "display": "Active",
            "userSelected": false
          }
        ],
        "text": "Active"
      },
      "verificationStatus": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
            "code": "confirmed",
            "display": "Confirmed",
            "userSelected": false
          }
        ],
        "text": "Confirmed"
      },
      "category": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
              "code": "health-concern",
              "display": "Health Concern"
            }
          ],
          "text": "Health Concern"
        }
      ],
      "code": {
        "text": "THIS IS A TEST GOAL"
      },
      "subject": {
        "reference": "Patient/12742400",
        "display": "SMART, TIMMY"
      },
      "onsetDateTime": "2020-12-03",
      "recordedDate": "2020-12-03T22:47:30.000Z"
    }
  ]
}

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/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203

Response

Status: 200 OK

{
  "resourceType": "Condition",
  "id": "p73077203",
  "meta": {
    "versionId": "73080185",
    "lastUpdated": "2020-06-11T04:05:04.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Category Classification</b>: Medical</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>"
  },
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "resolved",
        "display": "Resolved",
        "userSelected": false
      }
    ],
    "text": "Resolved"
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed",
        "display": "Confirmed",
        "userSelected": false
      }
    ],
    "text": "Confirmed"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "problem-list-item",
          "display": "Problem List Item"
        }
      ],
      "text": "Problem List Item"
    },
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "74188005",
          "display": "Medical (qualifier value)",
          "userSelected": false
        }
      ],
      "text": "Medical"
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "77386006",
        "display": "Patient currently pregnant (finding)",
        "userSelected": true
      }
    ],
    "text": "Pregnant"
  },
  "subject": {
    "reference": "Patient/12724066",
    "display": "SMART, NANCY"
  },
  "onsetDateTime": "2019-06-12",
  "abatementDateTime": "2020-04-04T17:00:00.000Z",
  "recordedDate": "2020-03-05T16:54:50.000Z",
  "recorder": {
    "reference": "Practitioner/683925",
    "display": "Cerner Test, Women's Health - Nurse Cerner"
  }
}

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.

Patient Authorization Request For Resolved Status

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p109117485

Response

Status: 200 OK

{
  "resourceType": "Condition",
  "id": "p109117485",
  "meta": {
    "versionId": "109117485",
    "lastUpdated": "2020-06-11T04:05:04.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Category Classification</b>: Medical</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>"
  },
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "resolved",
        "display": "Resolved",
        "userSelected": false
      }
    ],
    "text": "Resolved"
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed",
        "display": "Confirmed",
        "userSelected": false
      }
    ],
    "text": "Confirmed"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "problem-list-item",
          "display": "Problem List Item"
        }
      ],
      "text": "Problem List Item"
    },
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "74188005",
          "display": "Medical (qualifier value)",
          "userSelected": false
        }
      ],
      "text": "Medical"
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "77386006",
        "display": "Patient currently pregnant (finding)",
        "userSelected": true
      }
    ],
    "text": "Pregnant"
  },
  "subject": {
    "reference": "Patient/12742400",
    "display": "SMART, NANCY"
  },
  "onsetDateTime": "2019-06-12",
  "abatementDateTime": "2020-04-04T17:00:00.000Z",
  "recordedDate": "2020-03-05T16:54:50.000Z"
}

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.

Patient Authorization Request For Active Status

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/a077dc30-8eee-4bb7-ae7f-ced1273f5c68

Response

Status: 200 OK

{
  "resourceType": "Condition",
  "id": "a077dc30-8eee-4bb7-ae7f-ced1273f5c68",
  "meta": {
    "versionId": "a077dc30-8eee-4bb7-ae7f-ced1273f5c68",
    "lastUpdated": "2020-12-03T22:47:30.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, TIMMY</p><p><b>Health Concern</b>: THIS IS A TEST GOAL, THIS IS A TEST GOAL</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Dec  3, 2020</p><p><b>Recorded Date</b>: Dec  3, 2020 10:47 P.M. UTC</p></div>"
  },
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "active",
        "display": "Active",
        "userSelected": false
      }
    ],
    "text": "Active"
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed",
        "display": "Confirmed",
        "userSelected": false
      }
    ],
    "text": "Confirmed"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
          "code": "health-concern",
          "display": "Health Concern"
        }
      ],
      "text": "Health Concern"
    }
  ],
  "code": {
    "text": "THIS IS A TEST GOAL"
  },
  "subject": {
    "reference": "Patient/12742400",
    "display": "SMART, TIMMY"
  },
  "onsetDateTime": "2020-12-03",
  "recordedDate": "2020-12-03T22:47:30.000Z"
}

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.

Patient Authorization Request For Entered in Error Status

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2266495305

Response

Status: 200 OK

{
  "resourceType": "Condition",
  "id": "d2266495305",
  "meta": {
    "versionId": "2266495305"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Diagnosis</b>: Error, Error</p><p><b>Category Classification</b>: Medical</p><p><b>Verification Status</b>: Entered in Error</p></div>"
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "entered-in-error",
        "display": "Entered in Error"
      }
    ],
    "text": "Entered in Error"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "encounter-diagnosis",
          "display": "Encounter Diagnosis"
        }
      ],
      "text": "Encounter Diagnosis"
    },
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "74188005",
          "display": "Medical (qualifier value)",
          "userSelected": false
        }
      ],
      "text": "Medical"
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/data-absent-reason",
        "code": "error",
        "display": "Error"
      }
    ],
    "text": "Error"
  },
  "subject": {
    "reference": "Patient/12742400"
  }
}

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 Condition Create API supports only the API fields mentioned below. Unsupported fields will be ignored.
• Modifier fields should not be provided, and will cause the transaction to fail.
• 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
• The Condition Create API currently supports only Conditions with a category of problem-list-item or encounter-diagnosis.
• An encounter-diagnosis Condition will be automatically prioritized to the least significant priority by the Cerner Millennium EHR.
• On FHIR write of an encounter-diagnosis, the diagnosis will automatically receive the next available diagnosis priority within the problem list component.

Authorization Types

Headers

Authorization: <OAuth2 Bearer Token>
Content-Type: application/fhir+json

Body Fields

Name	Required	Type
resourceType	Yes	string
Description The type of the FHIR resource. Example { "resourceType": "Condition" } Notes resourceType must be Condition. top of section
clinicalStatus	Yes	CodeableConcept
Description The clinical status of the condition. Example { "clinicalStatus": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-clinical", "code": "resolved", "display": "Resolved" } ], "text": "Resolved" } } Notes A clinicalStatus must always be provided while creating a Condition. Only the active code is supported when the category is encounter-diagnosis. top of section
verificationStatus	No	CodeableConcept
Description The verification status to support or decline the clinical status of the condition or diagnosis. Example { "verificationStatus": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status", "code": "confirmed", "display": "Confirmed" } ], "text": "Confirmed" } } Notes verificationStatus codes of entered-in-error and refuted are not supported during Condition creates. top of section
category	Yes	List of CodeableConcept
Description A category assigned to the condition. Example { "category": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-category", "code": "problem-list-item", "display": "Problem List Item" } ], "text": "Problem List Item" } ] } Notes Only a single category may be provided. Category codes problem-list-item and encounter-diagnosis are supported. Classification codes are not supported. top of section
severity	No	CodeableConcept
Description A subjective assessment of the severity of the condition as evaluated by the clinician. Example { "severity": { "coding": [ { "system": "http://snomed.info/sct", "code": "255604002", "display": "Mild" } ] } } Example { "severity": { "coding": [ { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/12022", "code": "3293", "display": "Mild" } ] } } top of section
code	Yes	CodeableConcept
Description Identification of the condition, problem or diagnosis. Example { "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "209832007", "display": "Concussion NOS (disorder)", "userSelected": true } ], "text": "Concussion with loss of consciousness" } } Notes A code must be provided. top of section
subject	Yes	Reference
Description Indicates the patient who the condition record is associated with. Example { "subject": { "reference": "Patient/631923", "display": "Nilsson, Christine" } } Notes subject must be a reference to a Patient. top of section
encounter	No	Reference
Description Encounter during which the condition was first asserted. Example { "encounter": { "reference": "Encounter/631923" } } Notes encounter must be a reference to an Encounter. encounter is required when the condition category code is encounter-diagnosis. top of section
onset[x]	No	dateTime
Description Estimated or actual date or date-time the condition began, in the opinion of the clinician. Example { "onsetDateTime": "2015-10-14T13:13:20-06:00" } Notes Only a type of dateTime is supported. The dateTime is converted to a GMT date. top of section
abatement[x]	No	dateTime
Description The date or estimated date that the condition resolved or went into remission. Example { "abatementDateTime": "2015-10-14T13:13:20-06:00" } Notes abatementDateTime is not supported for Conditions with a category of encounter-diagnosis. top of section
note	No	List of Annotation
Description Additional information about the Condition. This is a general notes/comments entry for description of the Condition, its diagnosis and prognosis. Example { "note": [ { "authorReference": { "reference": "Practitioner/4594011", "display": "Leroux, Erik" }, "text": "Test Comment 2" } ] } top of section

Example

Request

POST https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition

Body

{
  "resourceType": "Condition",
  "subject": {
    "reference": "Patient/12724066"
  },
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "209832007",
        "display": "Concussion NOS (disorder)",
        "userSelected": true
      }
    ],
    "text": "Concussion with loss of consciousness"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "problem-list-item"
        }
      ],
      "text": "Problem"
    }
  ],
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "resolved"
      }
    ]
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed"
      }
    ]
  },
  "severity": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "6736007",
        "display": "Moderate"
      }
    ],
    "text": "Moderate"
  },
  "abatementDateTime": "2020-01-01",
  "onsetDateTime": "2018-01-01",
  "note": [
    {
      "authorString": "Freetext author",
      "text": "Test Comment 1"
    },
    {
      "authorReference": {
        "reference": "Practitioner/683925",
        "display": "Leroux, Erik"
      },
      "text": "Test Comment 2"
    }
  ]
}

Response

Status: 201 Created

Cache-Control: no-cache
Content-Length: 0
Content-Type: text/html
Date: Wed, 14 Aug 2019 17:23:14 GMT
Etag: W/"12793861"
Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p12793861
Last-Modified: Wed, 14 Aug 2019 17:23:14 GMT
Vary: Origin
X-Request-Id: 11111111111111111111111111111111

The ETag response header indicates the current If-Match version to use on a subsequent update.

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

• Currently problem-list-item and encounter-diagnosis are supported.
• 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.
• 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>
Content-Type: application/fhir+json
If-Match: W/"<Current version of the Condition resource>"

Body fields

Name	Required	Type
resourceType	Yes	string
Description The type of the FHIR resource. Example { "resourceType": "Condition" } Notes resourceType must be Condition. top of section
id	Yes	id
Description The logical id of the resource to update. Example { "id": "p123412" } Notes The id value must match the Condition/<id> value. top of section
clinicalStatus	No	CodeableConcept
Description The clinical status of the condition. Example { "clinicalStatus": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-clinical", "code": "resolved", "display": "Resolved" } ], "text": "Resolved" } } Notes A clinicalStatus must always be provided when updating a Condition, unless verificationStatus is entered-in-error or refuted. Only the active code is supported when the category is encounter-diagnosis. top of section
verificationStatus	No	CodeableConcept
Description The verification status to support or decline the clinical status of the condition or diagnosis. Example { "verificationStatus": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status", "code": "confirmed", "display": "Confirmed" } ], "text": "Confirmed" } } top of section
category	Yes	List of CodeableConcept
Description A category assigned to the condition. Example { "category": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-category", "code": "problem-list-item", "display": "Problem List Item" } ], "text": "Problem List Item" } ] } Notes Only a single category may be provided. Category codes problem-list-item and encounter-diagnosis are supported. Classification codes are not supported. top of section
severity	No	CodeableConcept
Description A subjective assessment of the severity of the condition as evaluated by the clinician. Example { "severity": { "coding": [ { "system": "http://snomed.info/sct", "code": "255604002", "display": "Mild" } ] } } Example { "severity": { "coding": [ { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/12022", "code": "3293", "display": "Mild" } ] } } top of section
code	Yes	CodeableConcept
Description Identification of the condition, problem or diagnosis. Example { "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "209832007", "display": "Concussion NOS (disorder)", "userSelected": true } ], "text": "Concussion with loss of consciousness" } } Notes A code must be provided. top of section
subject	Yes	Reference
Description Indicates the patient who the condition record is associated with. Example { "subject": { "reference": "Patient/631923", "display": "Nilsson, Christine" } } Notes subject must be a reference to a Patient. top of section
encounter	No	Reference
Description Encounter during which the condition was first asserted. Example { "encounter": { "reference": "Encounter/631923" } } Notes encounter must be a reference to an Encounter. encounter is only supported for Conditions with a category of encounter-diagnosis. top of section
onset[x]	No	dateTime
Description Estimated or actual date or date-time the condition began, in the opinion of the clinician. Example { "onsetDateTime": "2015-10-14T13:13:20-06:00" } Notes Only a type of dateTime is supported. The dateTime is converted to a GMT date. top of section
abatement[x]	No	dateTime
Description The date or estimated date that the condition resolved or went into remission. Example { "abatementDateTime": "2015-10-14T13:13:20-06:00" } Notes abatementDateTime is not supported for Conditions with a category of encounter-diagnosis. top of section
note	No	List of Annotation
Description Additional information about the Condition. This is a general notes/comments entry for description of the Condition, its diagnosis and prognosis. Example { "note": [ { "authorReference": { "reference": "Practitioner/4594011", "display": "Leroux, Erik" }, "text": "Test Comment 2" } ] } Notes note cannot be added if note already exists. An existing note field cannot be modified. top of section

Example

Request

PUT https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203

Body

{
  "resourceType": "Condition",
  "id": "p73077203",
  "subject": {
    "reference": "Patient/12724066"
  },
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "77386006",
        "display": "Patient currently pregnant (finding)",
        "userSelected": true
      }
    ],
    "text": "Pregnant"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "problem-list-item"
        }
      ],
      "text": "Problem"
    }
  ],
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "resolved"
      }
    ]
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "differential"
      }
    ]
  },
  "onsetDateTime": "2019-06-12",
  "abatementDateTime": "2020-04-04T17:00:00.000Z",
  "note": [
    {
      "authorReference": {
        "reference": "Practitioner/683925"
      },
      "text": "Test Comment"
    }
  ]
}

Response

Status: 200 OK

Cache-Control: no-cache
Content-Length: 0
Content-Type: text/html
Date: Tue, 20 Aug 2019 21:17:04 GMT
Etag: W/"12809861"
Last-Modified: TTue, 20 Aug 2019 21:17:04 GMT
Vary: Origin
X-Request-Id: 3e4cb2f732daacdb6cca2eb944e80e55

The ETag response header indicates the current If-Match version to use on subsequent update.

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.