Condition
Overview
For the Condition resource query, the API returns a consolidated list of conditions that providers have charted in the Soarian Problem List.
Problems returned may be in an active, inactive, or resolved state. Problems marked erroneous are not returned. Problems and their problem details depend on client configuration and charting practice. Problems returned include free text problems and structured problems configured in the clinical care category. The narrative response returns data as charted and may be more robust than the structured response.
Terminology Bindings
Condition.code |
|
Custom Extensions
The bundle extension can be returned, see possible codes in the errors section below.
Search
GET /Condition?:parameters
Implementation Notes
- The API returns the most current charted problem list.
- The API returns conditions in
active
,inactive
, andresolved
statuses. It will not return conditions marked asentered-in-error
. - The Narrative represents the entire condition and contains information that is not included in the structured portion of the response. As such, it should be shown to the user to ensure completeness of clinical content and context.
- The status entry in the narrative is valued “Additional” indicating that more information is provided in the narrative than is provided in the structure. Therefore, if the Application is using the structured entries for any purpose, care must be taken to ensure the clinical content/context of the narrative is preserved.
Parameters
Name | Required? | Type | Description |
---|---|---|---|
patientId | Y | reference | The patient identifier provided in a pre-requisite authorization step. |
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-myrecord.sandboxcerner.com/dstu2/123abc/Condition?patientId=1FNHDJ60-D6A1-441F-AA25-FB6FA6719CEA
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "da932c89-1ba4-4128-a974-ecdf34d6b6ce",
"meta": {
"lastUpdated": "2017-02-28T11:52:03.015-05:00"
},
"extension": [
{
"url": "http://cerner.hs.fhir.com/StructureDefinition/bundle-result-messages",
"valueExtension": {
"url": "http://cerner.hs.fhir.com/StructureDefinition/bundle-result-messages",
"extension": [
{
"url": "Severity",
"valueString": "info"
},
{
"url": "Code",
"valueString": "papi005"
},
{
"url": "Message",
"valueString": "This is the most current, known Problem list and may not reflect the state of problems known at a previous date."
}
]
}
}
],
"type": "searchset",
"link": [
{
"relation": "self",
"url": "base-url/bf615549-44cc-4899-bfa9-2cfd86bf358c/Condition?patientId=52930295-B52D-4685-B922-DC5F181CF786&_format=json"
}
],
"entry": [
{
"resource": {
"resourceType": "Condition",
"text": {
"status": "additional",
"div": "<li ccdRefId="ZProblems.Problems.6849581"><span style="font-size:10pt;font-weight:regular;color:black">Acute Pain<ul style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px;"><li>Body Location:Abdomen, Body Side:Right, Comment:This is a comment., Day Part:Daytime, Event:Admission, Frequency:Occasional, Location:Home, Onset:Unknown, Onset Date:2017-02-01 00:00:00, Perspective:Deep, Rank:2, Rank:1 - High, Severity:Moderate, Status:Active, Time Pattern:Continuous. </li></ul></span></li>"
},
"identifier": [
{
"use": "official",
"value": "ZProblems.Problems.6849581"
}
],
"patient": {
"reference": "Patient/52930295-B52D-4685-B922-DC5F181CF786"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "274663001",
"display": "Acute Pain"
}
],
"text": "Acute Pain"
},
"verificationStatus": "provisional"
}
},
{
"resource": {
"resourceType": "Condition",
"text": {
"status": "additional",
"div": "<li ccdRefId="ZProblems.Problems.6860283"><span style="font-size:10pt;font-weight:regular;color:black">Chronic rejection of renal translplant<ul style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px;"><li>Status:Active. </li></ul></span></li>"
},
"identifier": [
{
"use": "official",
"value": "ZProblems.Problems.6860283"
}
],
"patient": {
"reference": "Patient/52930295-B52D-4685-B922-DC5F181CF786"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "236578006",
"display": "Chronic rejection of renal translplant"
}
],
"text": "Chronic rejection of renal translplant"
},
"verificationStatus": "provisional"
}
}
]
}
Errors and Informational messages
The common errors and informational messages can be returned.
These additional informational messages may be returned within the bundle extension:
Code | Message |
---|---|
papi005 | This is the most current, known Problem list and may not reflect the state of problems known at a previous date. |
papi006 | No relevant problems exist. |