Condition

• Overview
• Terminology Bindings
• Search
  • Authorization Types
  • Parameters
  • Headers
  • Example Search by Patient
  • Example Search by ID
  • Errors
• Retrieve by ID
  • Authorization Types
  • Headers
  • Example
  • Errors

Overview

The Condition resource represents problems, diagnoses, and health concerns. Problems are either ongoing conditions not associated with a specific encounter or point-in-time conditions recorded in the context of an encounter. Diagnoses are point-in-time conditions recorded in the context of an encounter. Health concerns represent other health issues or situations that may require ongoing monitoring or management, such as financial or social risks.

Soarian Clinicals^® supports a read-only Application Programming Interface (API). This API accepts GET and POST based search and GET based read interactions. The response represents the most current information about the patient that is charted in Soarian Clinicals^® at the time of the query.

The search results include the following fields if they contain values:

• Condition Id
• Status
• Verification Status
• Category
• Code
• Subject
• Encounter

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. Details: Condition Category Codes System: http://terminology.hl7.org/CodeSystem/condition-category

Condition.code

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

Search

Search for Condition resources that meet the specified query parameters:

GET /Condition?:parameters

Authorization Types

Parameters

Name	Required?	Type	Description
_id	This, or patient	token	The logical resource id associated with the resource.
patient	This, or _id	reference	The patient who has the condition.
encounter	No	reference	The encounter associated with the condition.
status	No	token	The status of the condition. May be a list separated by commas.
_revinclude	No	_revinclude	A request to include any Provenance resource in the bundle that refers to a condition resource in the search results. Only supported with Provenance.

Notes:

• The _revinclude parameter may be provided once with the value Provenance:target. Example: _revinclude=Provenance:target
• When _revinclude is provided in a request, the OAuth2 token must include the patient/Provenance.read system/Provenance.read or user/Provenance.read scope as applicable.

Headers

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

Example Search by Patient

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition?patient=A879904FD2FE4B2D90C89FDA84E1285F

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "1a606271-341b-4ac4-aeb6-1931f27178ba",
  "type": "searchset",
  "timestamp": "2022-05-11T04:42:40-04:00",
  "entry": [
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition/A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "Condition",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074",
        "meta": {
          "lastUpdated": "2020-11-15T16:18:47-05:00"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ]
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ]
          }
        ],
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "code": {
          "text": "Depression"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>Condition</b><br /><b>Patient</b>: Mcgovern,Astrid Santiago<br /><b>Encounter</b>: Inferno,Initial<br /><b>Health Concern</b>: Depression<br /><b>Clinical Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-clinical <b>Code</b>:active <b>Display</b>:Active <br /><b>Verification Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-ver-status <b>Code</b>:confirmed <b>Display</b>:Confirmed <br /><b>Category</b>: <b>System</b>:http://hl7.org/fhir/us/core/CodeSystem/condition-category <b>Code</b>:health-concern <b>Display</b>:Health Concern <br /></div>"
        }
      }
    },
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition/A879904FD2FE4B2D90C89FDA84E1285F.DX.23409",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "Condition",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.DX.23409",
        "meta": {
          "lastUpdated": "2020-11-15T16:15:56-05:00"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ]
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/condition-category",
                "code": "encounter-diagnosis",
                "display": "Encounter Diagnosis"
              }
            ]
          }
        ],
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "code": {
          "coding": [
            {
              "system": "http://hl7.org/fhir/sid/icd-10-cm",
              "code": "D03.0",
              "display": "Melanoma in situ of lip"
            }
          ],
          "text": "Melanoma in situ of lip"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>Condition</b><br /><b>Patient</b>: Mcgovern,Astrid Santiago<br /><b>Encounter</b>: Inferno,Initial<br /><b>Diagnosis text</b>: Melanoma in situ of lip<br /><b>Diagnosis code</b>: <b>System</b>:http://hl7.org/fhir/sid/icd-10-cm <b>Code</b>:D03.0 <b>Display</b>:Melanoma in situ of lip <br /><b>Clinical Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-clinical <b>Code</b>:active <b>Display</b>:Active <br /><b>Verification Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-ver-status <b>Code</b>:confirmed <b>Display</b>:Confirmed <br /><b>Category</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-category <b>Code</b>:encounter-diagnosis <b>Display</b>:Encounter Diagnosis <br /></div>"
        }
      }
    },
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition/A879904FD2FE4B2D90C89FDA84E1285F.PRB.6885579",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "Condition",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.PRB.6885579",
        "meta": {
          "lastUpdated": "2020-11-15T16:15:06-05:00"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ]
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/condition-category",
                "code": "problem-list-item",
                "display": "Problem List Item"
              }
            ]
          }
        ],
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "code": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "87522002"
            }
          ],
          "text": "Iron Deficiency Anemia"
        },
        "text": {
          "status": "additional",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>Condition</b><br /><b>Patient</b>: Mcgovern,Astrid Santiago<br /><b>Encounter</b>: Inferno,Initial<br /><b>Problem text</b>: Iron Deficiency Anemia<br /><b>Problem code</b>: <b>System</b>:http://snomed.info/sct <b>Code</b>:87522002 <br /><b>Clinical Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-clinical <b>Code</b>:active <b>Display</b>:Active <br /><b>Verification Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-ver-status <b>Code</b>:confirmed <b>Display</b>:Confirmed <br /><b>Category</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-category <b>Code</b>:problem-list-item <b>Display</b>:Problem List Item <br /><b>Status</b>:Active <br /></div>"
        }
      }
    }
  ],
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition?patient=A879904FD2FE4B2D90C89FDA84E1285F"
    }
  ]
}

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 Search by ID

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition?_id=A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074

Response

Status: 200 OK

{
  "resourceType": "Bundle",
  "id": "1a606271-341b-4ac4-aeb6-1931f27178ba",
  "type": "searchset",
  "timestamp": "2022-05-11T04:42:40-04:00",
  "entry": [
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition/A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "Condition",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074",
        "meta": {
          "lastUpdated": "2020-11-15T16:18:47-05:00"
        },
        "clinicalStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
              "code": "active",
              "display": "Active"
            }
          ]
        },
        "verificationStatus": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
              "code": "confirmed",
              "display": "Confirmed"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
                "code": "health-concern",
                "display": "Health Concern"
              }
            ]
          }
        ],
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "code": {
          "text": "Depression"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>Condition</b><br /><b>Patient</b>: Mcgovern,Astrid Santiago<br /><b>Encounter</b>: Inferno,Initial<br /><b>Health Concern</b>: Depression<br /><b>Clinical Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-clinical <b>Code</b>:active <b>Display</b>:Active <br /><b>Verification Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-ver-status <b>Code</b>:confirmed <b>Display</b>:Confirmed <br /><b>Category</b>: <b>System</b>:http://hl7.org/fhir/us/core/CodeSystem/condition-category <b>Code</b>:health-concern <b>Display</b>:Health Concern <br /></div>"
        }
      }
    }
  ],
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition?patient=A879904FD2FE4B2D90C89FDA84E1285F"
    }
  ]
}

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 resource by its ID:

GET /Condition/:id

Authorization Types

Headers

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

Example

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Condition/A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074

Response

Status: 200 OK

{
  "resourceType": "Condition",
  "id": "A879904FD2FE4B2D90C89FDA84E1285F.NRS.43074",
  "meta": {
    "lastUpdated": "2020-11-15T16:18:47-05:00"
  },
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "active",
        "display": "Active"
      }
    ]
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed",
        "display": "Confirmed"
      }
    ]
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://hl7.org/fhir/us/core/CodeSystem/condition-category",
          "code": "health-concern",
          "display": "Health Concern"
        }
      ]
    }
  ],
  "subject": {
    "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
    "display": "Mcgovern,Astrid Santiago"
  },
  "encounter": {
    "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
    "display": "Inferno,Initial"
  },
  "code": {
    "text": "Depression"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>Condition</b><br /><b>Patient</b>: Mcgovern,Astrid Santiago<br /><b>Encounter</b>: Inferno,Initial<br /><b>Health Concern</b>: Depression<br /><b>Clinical Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-clinical <b>Code</b>:active <b>Display</b>:Active <br /><b>Verification Status</b>: <b>System</b>:http://terminology.hl7.org/CodeSystem/condition-ver-status <b>Code</b>:confirmed <b>Display</b>:Confirmed <br /><b>Category</b>: <b>System</b>:http://hl7.org/fhir/us/core/CodeSystem/condition-category <b>Code</b>:health-concern <b>Display</b>:Health Concern <br /></div>"
  }
}

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.