Condition

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 fields are returned if valued:

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/ValueSet/us-core-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 for Conditions that meet supplied query parameters:

GET /Condition?:parameters

Implementation Notes

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

Notes:

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/ValueSet/us-core-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/ValueSet/us-core-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/ValueSet/us-core-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/ValueSet/us-core-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

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.
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.
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.
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.
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"
            }
          ]
        }
      }
      
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.
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.
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.
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.
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.
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"
          }
        ]
      }
      

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

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.
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.
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.
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"
        }
      }
      
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.
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"
            }
          ]
        }
      }
      
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.
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.
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.
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.
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.
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.

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.