Condition

Overview
Terminology Bindings
Search
Retrieve by id
Create
Update

Overview

The Condition resource is used to record details about a patient’s problems, diagnoses, or other health matters that are concerning. It is common to capture Conditions during the encounter or visit. This is usually captured both as initial suspected problems and confirmed or refuted problems or diagnoses at the time of discharge. This resource may be referenced by other resources as a “reason” for an action or order such as the reason for ordering a medication or procedure.

This resource is NOT intended to record subjective or objective information that could lead to the recording of a condition such as signs or symptoms. Signs and symptoms are typically documented as Observations although some persistent symptoms such as fever or headache may be documented prior to the definitive diagnosis being recognized by a clinician.

References to implicitRules and modifierExtension fields are NOT supported and will fail a Create or Update request.

The following fields are returned if valued:

Terminology Bindings

Condition.code

Description

Identification of the condition 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

Condition.category

Description

A category assigned to the condition.

Note

Category codes diagnosis, problem and health-concern are supported for search and retrieve functionality. Codes diagnosis and problem are supported for conditions add and update functionality.

Details: Condition Category Codes
System: http://hl7.org/fhir/condition-category

Details: Argonaut Valueset Codes
System: http://argonaut.hl7.org

Condition.clinicalStatus

Description

Preferred value set for Condition Clinical Status.

Details: Clinical Status
System: http://hl7.org/fhir/condition-clinical

Condition.clinicalStatus

Description

Preferred value set for Condition Clinical Status.

Details: Clinical Status
System: http://hl7.org/fhir/condition-clinical

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

Condition.meta.security

Description

These tags connect specific resources to the overall security policy and infrastructure.

Details: ValueSet
System: http://terminology.hl7.org/CodeSystem/v3-ActCode

Search

Search for Conditions that meet supplied query parameters:

GET /Condition?:parameters

Authorization Types

Provider | Patient | System

Parameters

Name	Required?	Type	Description
`_id`	This or `patient`, if populated all other parameters are not allowed	`token`	The logical resource id associated with the resource. Example: `p12345`
`patient`	This or `_id`	`reference`	The patient who has the condition. Example: `12345`
`category`	N	`token`	The category of the condition. Example: `diagnosis`, `problem`, `health-concern`
`clinicalstatus`	N	`token`	The clinical status of the condition. Example: `resolved`

Notes:

Currently only diagnosis, problem and health-concern category codes are supported.

Headers

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

Example

Request

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

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
  "type": "searchset",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?patient=12724066"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
      "resource": {
        "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
        "resource": {
          "resourceType": "Condition",
          "id": "d2572382197",
          "meta": {
            "versionId": "2572382197",
            "lastUpdated": "2020-06-11T04:03:21.000Z",
            "security": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PHY",
                "display": "physician requested information sensitivity",
                "userSelected": false
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PRS",
                "display": "patient requested information sensitivity",
                "userSelected": false
              }
            ]
          },
          "text": {
            "status": "generated",
            "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Diagnosis</b>: Anemia, Anemia (disorder)</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 10, 2020  5:00 P.M. UTC</p></div>"
          },
          "patient": {
            "reference": "Patient/12724066",
            "display": "SMART, NANCY"
          },
          "encounter": {
            "reference": "Encounter/97953477"
          },
          "dateRecorded": "2020-06-11",
          "code": {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "271737000",
                "display": "Anemia (disorder)",
                "userSelected": true
              },
              {
                "system": "http://hl7.org/fhir/sid/icd-10-cm",
                "code": "D64.9",
                "display": "Anemia, unspecified",
                "userSelected": false
              }
            ],
            "text": "Anemia"
          },
          "category": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/condition-category",
                "code": "diagnosis",
                "display": "Diagnosis"
              }
            ],
            "text": "Diagnosis"
          },
          "clinicalStatus": "active",
          "verificationStatus": "confirmed",
          "onsetDateTime": "2020-06-10T17:00:00.000Z"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203",
      "resource": {
        "resourceType": "Condition",
        "id": "p73077203",
        "meta": {
          "versionId": "73079095",
          "lastUpdated": "2020-04-05T04:00:46.000Z",
          "security": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
              "code": "PHY",
              "display": "physician requested information sensitivity",
              "userSelected": false
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
              "code": "PRS",
              "display": "patient requested information sensitivity",
              "userSelected": false
            }
          ]
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Clinical Status</b>: Resolved</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 12, 2019</p><p><b>Resolved</b>: Apr  4, 2020  5:00 P.M. UTC</p></div>"
        },
        "patient": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "dateRecorded": "2020-03-05",
        "code": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "77386006",
              "display": "Patient currently pregnant (finding)",
              "userSelected": true
            }
          ],
          "text": "Pregnant"
        },
        "category": {
          "coding": [
            {
              "system": "http://argonaut.hl7.org",
              "code": "problem",
              "display": "Problem"
            }
          ],
          "text": "Problem"
        },
        "clinicalStatus": "resolved",
        "verificationStatus": "confirmed",
        "onsetDateTime": "2019-06-12",
        "abatementDateTime": "2020-04-04T17:00:00.000Z"
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
      "resource": {
        "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
        "resource": {
          "resourceType": "Condition",
          "id": "00a5d6eb-c567-42f7-be07-53804cece075",
          "meta": {
            "versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
            "lastUpdated": "2020-07-06T19:36:23.000Z",
            "security": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PHY",
                "display": "physician requested information sensitivity",
                "userSelected": false
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PRS",
                "display": "patient requested information sensitivity",
                "userSelected": false
              }
            ]
          },
          "text": {
            "status": "generated",
            "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul  6, 2020</p><p><b>Resolved</b>: False</p></div>"
          },
          "patient": {
            "reference": "Patient/12724066",
            "display": "SMART, NANCY"
          },
          "dateRecorded": "2020-07-06",
          "code": {
            "text": "Afraid my community will not be as close with COVID19."
          },
          "category": {
            "coding": [
              {
                "system": "http://argonaut.hl7.org",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ],
            "text": "Health Concern"
          },
          "clinicalStatus": "active",
          "verificationStatus": "confirmed",
          "onsetDateTime": "2020-07-06",
          "abatementBoolean": false,
          "notes": "Concerns with impact of COVID19 on community."
        }
      }
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

The meta.security field will be present only when a problem or diagnosis is marked as confidential.

Example Read by Ids

Request

GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=d2572382197,p73077203,00a5d6eb-c567-42f7-be07-53804cece075

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "5a31a14a-9740-459c-bc52-b105b81ebebc",
  "type": "searchset",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition?_id=d2572382197,p73077203,00a5d6eb-c567-42f7-be07-53804cece075"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
      "resource": {
        "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2572382197",
        "resource": {
          "resourceType": "Condition",
          "id": "d2572382197",
          "meta": {
            "versionId": "2572382197",
            "lastUpdated": "2020-06-11T04:03:21.000Z",
            "security": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PHY",
                "display": "physician requested information sensitivity",
                "userSelected": false
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PRS",
                "display": "patient requested information sensitivity",
                "userSelected": false
              }
            ]
          },
          "text": {
            "status": "generated",
            "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Diagnosis</b>: Anemia, Anemia (disorder)</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 10, 2020  5:00 P.M. UTC</p></div>"
          },
          "patient": {
            "reference": "Patient/12724066",
            "display": "SMART, NANCY"
          },
          "encounter": {
            "reference": "Encounter/97953477"
          },
          "dateRecorded": "2020-06-11",
          "code": {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "271737000",
                "display": "Anemia (disorder)",
                "userSelected": true
              },
              {
                "system": "http://hl7.org/fhir/sid/icd-10-cm",
                "code": "D64.9",
                "display": "Anemia, unspecified",
                "userSelected": false
              }
            ],
            "text": "Anemia"
          },
          "category": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/condition-category",
                "code": "diagnosis",
                "display": "Diagnosis"
              }
            ],
            "text": "Diagnosis"
          },
          "clinicalStatus": "active",
          "verificationStatus": "confirmed",
          "onsetDateTime": "2020-06-10T17:00:00.000Z"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73077203",
      "resource": {
        "resourceType": "Condition",
        "id": "p73077203",
        "meta": {
          "versionId": "73079095",
          "lastUpdated": "2020-04-05T04:00:46.000Z",
          "security": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
              "code": "PHY",
              "display": "physician requested information sensitivity",
              "userSelected": false
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
              "code": "PRS",
              "display": "patient requested information sensitivity",
              "userSelected": false
            }
          ]
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p><p><b>Clinical Status</b>: Resolved</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 12, 2019</p><p><b>Resolved</b>: Apr  4, 2020  5:00 P.M. UTC</p></div>"
        },
        "patient": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "dateRecorded": "2020-03-05",
        "code": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "77386006",
              "display": "Patient currently pregnant (finding)",
              "userSelected": true
            }
          ],
          "text": "Pregnant"
        },
        "category": {
          "coding": [
            {
              "system": "http://argonaut.hl7.org",
              "code": "problem",
              "display": "Problem"
            }
          ],
          "text": "Problem"
        },
        "clinicalStatus": "resolved",
        "verificationStatus": "confirmed",
        "onsetDateTime": "2019-06-12",
        "abatementDateTime": "2020-04-04T17:00:00.000Z"
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
      "resource": {
        "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
        "resource": {
          "resourceType": "Condition",
          "id": "00a5d6eb-c567-42f7-be07-53804cece075",
          "meta": {
            "versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
            "lastUpdated": "2020-07-06T19:36:23.000Z",
            "security": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PHY",
                "display": "physician requested information sensitivity",
                "userSelected": false
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "PRS",
                "display": "patient requested information sensitivity",
                "userSelected": false
              }
            ]
          },
          "text": {
            "status": "generated",
            "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul  6, 2020</p><p><b>Resolved</b>: False</p></div>"
          },
          "patient": {
            "reference": "Patient/12724066",
            "display": "SMART, NANCY"
          },
          "dateRecorded": "2020-07-06",
          "code": {
            "text": "Afraid my community will not be as close with COVID19."
          },
          "category": {
            "coding": [
              {
                "system": "http://argonaut.hl7.org",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ],
            "text": "Health Concern"
          },
          "clinicalStatus": "active",
          "verificationStatus": "confirmed",
          "onsetDateTime": "2020-07-06",
          "abatementBoolean": false,
          "notes": "Concerns with impact of COVID19 on community."
        }
      }
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

The meta.security field will be present only when a problem or diagnosis is marked as confidential.

Errors

The common errors and OperationOutcomes may be returned.

Retrieve by id

List an individual Condition by its id:

GET /Condition/:id

Authorization Types

Provider | Patient | System

Headers

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

Example

Request

GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075

Response

Status: 200 OK

{
  "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/00a5d6eb-c567-42f7-be07-53804cece075",
  "resource": {
    "resourceType": "Condition",
    "id": "00a5d6eb-c567-42f7-be07-53804cece075",
    "meta": {
      "versionId": "00a5d6eb-c567-42f7-be07-53804cece075",
      "lastUpdated": "2020-07-06T19:36:23.000Z",
      "security": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
          "code": "PHY",
          "display": "physician requested information sensitivity",
          "userSelected": false
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
          "code": "PRS",
          "display": "patient requested information sensitivity",
          "userSelected": false
        }
      ]
    },
    "text": {
      "status": "generated",
      "div": "<div><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Health Concern</b>: Afraid my community will not be as close with COVID19.</p><p><b>Clinical Status</b>: Active</p><p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jul  6, 2020</p><p><b>Resolved</b>: False</p></div>"
    },
    "patient": {
      "reference": "Patient/12724066",
      "display": "SMART, NANCY"
    },
    "dateRecorded": "2020-07-06",
    "code": {
      "text": "Afraid my community will not be as close with COVID19."
    },
    "category": {
      "coding": [
        {
          "system": "http://argonaut.hl7.org",
          "code": "health-concern",
          "display": "Health Concern"
        }
      ],
      "text": "Health Concern"
    },
    "clinicalStatus": "active",
    "verificationStatus": "confirmed",
    "onsetDateTime": "2020-07-06",
    "abatementBoolean": false,
    "notes": "Concerns with impact of COVID19 on community."
  }
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

The meta.security field will be present only when a problem or diagnosis is marked as confidential.

Errors

The common errors and OperationOutcomes may be returned.

Create

Create a new condition.

POST /Condition

Implementation Notes

The following restrictions are in place based on Condition.category:
- For Conditions with a category code of diagnosis:
  - Condition.encounter is required.
  - Condition.abatementDateTime is not supported.
- For Conditions with a category code of problem:
  - If Condition.dateRecorded is set on the request body, its value will currently be ignored.
- Creating Conditions with a category code of health-concern is not currently supported.
The code.coding field can have at most 2 codings.
- One of the codings must have userSelected: true
- The other coding must have userSelected: false
A Condition with a category code of diagnosis will be automatically prioritized to the least significant priority by the Cerner Millennium EHR.

Authorization Types

Provider | System

Headers

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

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
`patient`	Yes	`Reference` (`Patient`)
Description Who has the condition. Example { "patient": { "reference": "Patient/2744123", "display": "Joe, Test" } } top of section
`encounter`	No	`Reference` (`Encounter`)
Description Encounter during which the condition was first asserted. Example { "encounter": { "reference": "Encounter/1309819" } } Notes Encounter is required for Conditions with a category code of diagnosis. top of section
`code`	Yes	`CodeableConcept`
Description Identification of the condition, problem, diagnosis or health concern. Example { "code": { "coding": [ { "system": "http://hl7.org/fhir/sid/icd-9-cm", "code": "345.0", "display": "Generalized nonconvulsive epilepsy", "userSelected": true } ], "text": "Absence seizures" } } top of section
`category`	No	`CodeableConcept`
Description A category assigned to the condition. Example { "category": { "coding": [ { "system": "http://hl7.org/fhir/condition-category", "code": "diagnosis", "display": "Diagnosis" } ], "text": "Diagnosis" } } OR { "category": { "coding": [ { "system": "http://argonaut.hl7.org", "code": "problem", "display": "Problem" } ], "text": "Problem" } } top of section
`clinicalStatus`	No	`code`
Description The clinical status of the condition. Example {"clinicalStatus": "resolved"} top of section
`verificationStatus`	Yes	`code`
Description The verification status of the condition. Example { "verificationStatus": "confirmed" } top of section
`severity`	No	`CodeableConcept`
Description Assessment of the severity of the condition as evaluated by the clinician. Example { "severity": { "coding": [ { "system": "http://snomed.info/sct", "code": "371923003", "display": "Mild to moderate" } ], "text": "Mild to moderate" } } top of section
`onsetDateTime`	No	`dateTime`
Description Estimated or actual date the condition began, in the opinion of the clinician. Example { "onsetDateTime": "2015-10-14T13:13:20-06:00" } top of section
`abatementBoolean`	No	`boolean`
Description Indicates if the condition is resolved or has gone into remission. Example { "abatementBoolean": true } top of section
`abatementDateTime`	No	`dateTime`
Description Indicates the date and time the condition was resolved or has gone into remission. Example { "abatementDateTime": "2015-10-14T13:13:20-06:00" } top of section
`notes`	No	`string`
Description Additional information about the Condition. Example { "notes": "Information related to condition" } top of section

Create Problem Example

Request

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

Body

{
  "resourceType": "Condition",
  "patient": {
    "reference": "Patient/12724066"
  },
  "code": {
    "text": "Freetext Condition"
  },
  "category": {
    "coding": [
      {
        "system": "http://argonaut.hl7.org",
        "code": "problem",
        "display": "Problem"
      }
    ],
    "text": "Problem"
  },
  "clinicalStatus": "resolved",
  "verificationStatus": "differential",
  "abatementDateTime": "2017-01-01T00:00:00Z"
}

Response

Status: 201 Created

Date: Tue, 28 Feb 2017 21:26:37 GMT
Cache-Control: no-cache
Vary: Origin,User-Agent,Accept-Encoding
Strict-Transport-Security: max-age=631152000
X-Xss-Protection: 1; mode=block
Pragma: no-cache
X-Request-Id: 78a19072002b8651623351cfedaffe70
Etag: W/"6809861"
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Last-Modified: Tue, 28 Feb 2017 21:26:44 GMT
Location: https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p6809861
Content-Length: 0
Content-Type: application/json

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

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Create Diagnosis Example

Request

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

Body

{
  "resourceType": "Condition",
  "patient": {
    "reference": "Patient/12724066"
  },
  "code": {
    "text": "Freetext Diagnosis"
  },
  "category": {
    "coding": [
      {
        "system": "http://hl7.org/fhir/condition-category",
        "code": "diagnosis",
        "display": "Diagnosis"
      }
    ],
    "text": "Diagnosis"
  },
  "clinicalStatus": "active",
  "verificationStatus": "differential",
  "encounter": {
    "reference": "Encounter/97953477"
  }
}

Response

Status: 201 Created

Date: Tue, 28 Feb 2017 21:30:28 GMT
Cache-Control: no-cache
Vary: Origin,User-Agent,Accept-Encoding
Strict-Transport-Security: max-age=631152000
X-Xss-Protection: 1; mode=block
Pragma: no-cache
X-Request-Id: 1b0d589dde95bcafcefd3a1965b5cadf
Etag: W/"36474555"
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Last-Modified: Tue, 28 Feb 2017 21:30:28 GMT
Location: https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d36474555
Content-Length: 0
Content-Type: application/json

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

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Update

Update an existing condition.

PUT /Condition/:id

Implementation Notes

Any field which is missing will be interpreted as nulling out or removing data from the resource. See FHIR^® Update for additional details about update operations.
Currently, health-concern category code is not supported for updating conditions.
The code.coding field can have at most 2 codings, one of which must be set as userSelected true and the other one must be set as userSelected false.

Authorization Types

Provider | System

Headers

Authorization: <OAuth2 Bearer Token>
Accept: application/json+fhir
Content-Type: application/json+fhir
If-Match: W/"<Current version of the Condition resource>"

Body fields

Notes:

abatementDateTime is not supported for Conditions with a category of diagnosis.
notes cannot be added if notes already exists. An existing notes field cannot be modified.

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
`patient`	Yes	`Reference` (`Patient`)
Description Who has the condition. Example { "patient": { "reference": "Patient/2744123", "display": "Joe, Test" } } top of section
`encounter`	No	`Reference` (`Encounter`)
Description Encounter during which the condition was first asserted. Example { "encounter": { "reference": "Encounter/1309819" } } Notes Encounter is required for Conditions with a category code of diagnosis. top of section
`dateRecorded`	No	`date`
Description Estimated or actual date the condition/problem/diagnosis was first entered. Example { "dateRecorded": "2013-02-08" } top of section
`code`	Yes	`CodeableConcept`
Description Identification of the condition, problem, diagnosis or health concern. Example { "code": { "coding": [ { "system": "http://hl7.org/fhir/sid/icd-9-cm", "code": "345.0", "display": "Generalized nonconvulsive epilepsy", "userSelected": true } ], "text": "Absence seizures" } } top of section
`category`	No	`CodeableConcept`
Description A category assigned to the condition. Example { "category": { "coding": [ { "system": "http://hl7.org/fhir/condition-category", "code": "diagnosis", "display": "Diagnosis" } ], "text": "Diagnosis" } } OR { "category": { "coding": [ { "system": "http://argonaut.hl7.org", "code": "problem", "display": "Problem" } ], "text": "Problem" } } top of section
`clinicalStatus`	No	`code`
Description The clinical status of the condition. Example {"clinicalStatus": "resolved"} Notes When the category is `encounter-diagnosis`, a clinicalStatus with the value of `active` must be provided, unless the verificationStatus is `entered-in-error`. When the category is `encounter-diagnosis` and the verificationStatus is `entered-in-error`, the clinicalStatus must not be provided. top of section
`verificationStatus`	Yes	`code`
Description The verification status of the condition. Example { "verificationStatus": "confirmed" } top of section
`severity`	No	`CodeableConcept`
Description Assessment of the severity of the condition as evaluated by the clinician. Example { "severity": { "coding": [ { "system": "http://snomed.info/sct", "code": "371923003", "display": "Mild to moderate" } ], "text": "Mild to moderate" } } top of section
`onsetDateTime`	No	`dateTime`
Description Estimated or actual date the condition began, in the opinion of the clinician. Example { "onsetDateTime": "2015-10-14T13:13:20-06:00" } top of section
`abatementBoolean`	No	`boolean`
Description Indicates if the condition is resolved or has gone into remission. Example { "abatementBoolean": true } top of section
`abatementDateTime`	No	`dateTime`
Description Indicates the date and time the condition was resolved or has gone into remission. Example { "abatementDateTime": "2015-10-14T13:13:20-06:00" } top of section
`notes`	No	`string`
Description Additional information about the Condition. Example { "notes": "Information related to condition" } top of section

Example

Request

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

Body

{
  "resourceType": "Condition",
  "id": "d2572382197",
  "meta": {
    "versionId": "2572382197",
    "lastUpdated": "2020-06-11T04:03:21.000Z"
  },
  "patient": {
    "reference": "Patient/12724066"
  },
  "encounter": {
    "reference": "Encounter/97953477"
  },
  "dateRecorded": "2020-06-11",
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "271737000",
        "display": "Anemia (disorder)",
        "userSelected": true
      },
      {
        "system": "http://hl7.org/fhir/sid/icd-10-cm",
        "code": "D64.9",
        "display": "Anemia, unspecified",
        "userSelected": false
      }
    ],
    "text": "Anemia"
  },
  "category": {
    "coding": [
      {
        "system": "http://hl7.org/fhir/condition-category",
        "code": "diagnosis",
        "display": "Diagnosis"
      }
    ],
    "text": "Diagnosis"
  },
  "clinicalStatus": "resolved",
  "verificationStatus": "differential",
  "onsetDateTime": "2020-06-10T17:00:00.000Z"
}

Response

Status: 200 OK

Date: Wed, 01 Mar 2017 15:42:52 GMT
Cache-Control: no-cache
Vary: Origin,User-Agent,Accept-Encoding
Strict-Transport-Security: max-age=631152000
X-Xss-Protection: 1; mode=block
Pragma: no-cache
X-Request-Id: c58a2925586fa64a89568b9ceac14475
Etag: W/"43538555"
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Last-Modified: Wed, 01 Mar 2017 15:42:52 GMT
Content-Length: 0
Content-Type: application/json

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

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Millennium

Condition

Overview

Terminology Bindings

Search

Authorization Types

Parameters

Headers

Example

Request

Response

Example Read by Ids

Request

Response

Errors

Retrieve by id

Authorization Types

Headers

Example

Request

Response

Errors

Create

Authorization Types

Headers

Body fields

Create Problem Example

Request

Body

Response

Create Diagnosis Example

Request

Body

Response

Errors

Update

Authorization Types

Headers

Body fields

Example

Request

Body

Response

Errors