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 HL7® FHIR® US Core Implementation Guide STU 4.0.0 Profiles are supported by this resource:
The following fields are returned if valued:
- Id
- Clinical status
- Verification status
- Category
- Severity
- Condition code
- Subject
- Patient encounter when first recorded (only applies to diagnoses)
- Onset
- Resolved date (only applies to problems and health-concerns)
- Date recorded
- Who recorded the condition
- Asserter
- Comment/Note
Terminology Bindings
Condition.clinicalStatus |
|
Condition.verificationStatus |
|
Condition.category |
|
Condition.severity |
|
Condition.code |
Search
Search for Conditions that meet supplied query parameters:
GET /Condition?:parameters
Implementation Notes
- Currently
problem-list-item
,encounter-diagnosis
andhealth-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 valueProvenance: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 theuser/Provenance.read
scope. Currentlypatient/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
orencounter-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 |
|
|
|||
clinicalStatus
|
Yes |
CodeableConcept |
|
|
|||
verificationStatus
|
No |
CodeableConcept |
|
|
|||
category
|
Yes |
List of CodeableConcept |
|
|
|||
severity
|
No |
CodeableConcept |
|
|
|||
code
|
Yes |
CodeableConcept |
|
|
|||
subject
|
Yes |
Reference |
|
|
|||
encounter
|
No |
Reference |
|
|
|||
onset[x]
|
No |
dateTime |
|
|
|||
abatement[x]
|
No |
dateTime |
|
|
|||
note
|
No |
List of Annotation |
|
|
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
andencounter-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 |
|
|
|||
id
|
Yes |
id |
|
|
|||
clinicalStatus
|
No |
CodeableConcept |
|
|
|||
verificationStatus
|
No |
CodeableConcept |
|
|
|||
category
|
Yes |
List of CodeableConcept |
|
|
|||
severity
|
No |
CodeableConcept |
|
|
|||
code
|
Yes |
CodeableConcept |
|
|
|||
subject
|
Yes |
Reference |
|
|
|||
encounter
|
No |
Reference |
|
|
|||
onset[x]
|
No |
dateTime |
|
|
|||
abatement[x]
|
No |
dateTime |
|
|
|||
note
|
No |
List of Annotation |
|
|
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.