Condition

Top  Previous  Next

A clinical condition, problem, diagnosis, or other event, situation, issue, or clinical concept that has risen to a level of concern.

Health Concerns and Problem list are available with the Condition resource.

Response Description

Sample Response

{

  "resourceType": "Condition",

  "id": "DEV-DEV-11913-17267",

  "meta": {

     "lastUpdated": "2022-11-08T12:00:00-05:00",

     "profile": [

        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition"

     ]

  },

  "text": {

     "status": "generated",

     "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><table><tbody><tr><td>Patient:</td><td>Cole Andersonian (DEV-DEV-11913)</td></tr><tr><td>Encounter:</td><td>accountLevel</td></tr><tr><td></td></tr><tr><td>Status:</td><td>inactive</td></tr><tr><td>Condition:</td><td>Diabetes mellitus (SNOMED-CT: 73211009)</td></tr><tr><td>Onset Date</td><td>01/09/2015</td></tr><tr><td></td></tr><tr><td>Recorded Date:</td><td>11/08/2022</td></tr><tr><td>Recorder:</td><td>gvtadaws</td></tr></tbody></table></div>"

  },

  "extension": [

     {

        "url": "http://hl7.org/fhir/StructureDefinition/condition-assertedDate",

        "valueDateTime": "2022-11-08"

     }

  ],

  "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": "unconfirmed",

           "display": "Unconfirmed"

        }

     ]

  },

  "category": [

     {

        "coding": [

           {

              "system": "http://terminology.hl7.org/CodeSystem/condition-category",

              "code": "problem-list-item",

              "display": "Problem List Item"

           }

        ]

     }

  ],

  "code": {

     "coding": [

        {

           "system": "http://snomed.info/sct",

           "code": "73211009",

           "display": "Diabetes mellitus (disorder)"

        }

     ],

     "text": "Diabetes mellitus"

  },

  "subject": {

     "reference": "Patient/DEV-DEV-11913",

     "display": "Cole Andersonian (DEV-DEV-11913)"

  },

  "onsetDateTime": "2015-01-09",

  "note": [

     {

        "text": "Not clear whether this was originally type 1 or type 2 diabetes, but patient is now ID and brittle."

     }

  ],

  "recordedDate": "2022-11-08",

  "recorder": {

     "reference": "Practitioner/GVTADAWS"

  }

}

 

 

Condition.id

 

The logical ID of the resource, as used in the URL for the resource. Once assigned, this value never changes.

Cardinality

0..1

Type

string

 

 

Condition.meta

 

Metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

Cardinality

0..1

Type

Meta

 

 

Condition.text

 

A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative.

Cardinality

0..1

Type

Narrative

Comment

Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

 

 

Condition.clinicalStatus

 

The clinical status of the condition.

Cardinality

0..1

Type

CodeableConcept: active | inactive | resolved | unknown

Comment

The data type is CodeableConcept because clinicalStatus has some clinical judgment involved, such that there might need to be more specificity than the required FHIR value set allows. For example, a SNOMED coding might allow for additional specificity

 

 

Condition.verificationStatus

 

Whether the condition has been confirmed

Cardinality

0..1

Type

CodeableConcept: unconfirmed | confirmed

Comment

verificationStatus is not required. For example, when a patient has abdominal pain in the ED, there is not likely going to be a verification status. The data type is CodeableConcept because verificationStatus has some clinical judgment involved, such that there might need to be more specificity than the required FHIR value set allows. For example, a SNOMED coding might allow for additional specificity.

 

 

Condition.category

 

A category assigned to the condition.

Cardinality

1..1

Type

CodeableConcept: problem-list-item

Comment

The categorization is often highly contextual and may appear poorly differentiated or not very useful in other contexts.

 

 

Condition.code

 

Identification of the condition, problem or diagnosis. This is expected to be an ICD-10 code or SNOMED-CT.

Cardinality

1..1

Type

CodeableConcept: Condition/Problem/Diagnosis Codes

 

 

Condition.subject

 

Indicates the patient or group with whom the condition record is associated.

Cardinality

1..1

Type

Reference(US Core Patient Profile)

Requirements

Who has the condition

 

 

Condition.encounter

 

The resource ID of the Encounter during which this Condition was created or to which the creation of this record is tightly associated.

Cardinality

0..1

Type

Reference(USCoreEncounterProfile)

Comment

This will typically be the encounter the event occurred within, but some activities may be initiated prior to or after the official completion of an encounter but still be tied to the context of the encounter.

 

 

Condition.onsetDateTime

 

Estimated or actual date-time the condition began, in the opinion of the clinician.

Cardinality

0..1

Type

dateTime

Comment

Age is generally used when the patient reports an age at which the Condition began to occur.

 

 

Condition.abatementDateTime

 

Estimated or actual date-time the condition resolved, in the opinion of the clinician.

Cardinality

0..1

Type

dateTime

Comment

If there is no abatement element, it is unknown whether the condition has resolved or entered remission; applications and users should generally assume that the condition is still valid. When abatementString exists, it implies the condition is abated.

 

 

Condition.note

 

Additional information about the Condition

Cardinality

0..*

Type

Annotation

 

 

Condition.recordedDate

 

Represents when this particular Condition record was created in the system, which is often a system-generated date.

Cardinality

0..1

Type

dateTime

 

 

Condition.recorder

 

Who recorded the Condition

Cardinality

0..1

Type

Reference(USCorePractitionerProfile)

 


 

Search

 

URL Syntax

Two HTTP methods are supported for searching: GET and POST. It is recommended to use HTTP POST.

Visit the FHIR Sandbox to try requests.

 

 

HTTP GET - searching

https://sandbox.pai.healthcare/preview/fhir/Condition?{query string}

 

HTTP GET - return single record

https://sandbox.pai.healthcare/preview/fhir/Condition/{resource id}

 

HTTP POST - searching

https://sandbox.pai.healthcare/preview/fhir/Condition/_search

Set the Content-Type header to application/x-www-urlencoded

The body of the request is a similar query string used in the GET type of request detailed above.

 

 

Error Handling

If no records are returned or invalid search parameters are provided, then an HTTP 400 Bad Request is returned.

The body of the response will be an OperationOutcome.

 

 

Supported Search Parameters

 

_id

Corresponds to

Condition.id

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?_id=dev-dev-test-9888

 

Returns a single Condition for patient 1 in the dev practice.

 

patient

Corresponds to

Condition.subject

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?patient=Patient/dev-dev-test

 

Returns Conditions for patient test in the dev practice.

 

encounter

Corresponds to

Condition.encounter

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?_id=dev-dev-b1sample2-0003460

 

Returns all Condition records for appointment #0003460 for account b1sample2 in the dev practice.

 

onset-date

Corresponds to

Condition.onsetDateTime

Search

exact using the format of yyyy-MM-dd

Modifiers

ge - greater than or equal to

gt - greater than

le - less than or equal to

lt - less than

eq - equal to

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?onset-date=2017-12-15&patient=dev-dev-11913

 

Returns the Conditions for patient 11913 with diagnosis date on 12/15/2017.

 

clinical-status

Corresponds to

Condition.clinicalStatus

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?clinical-status=resolved&patient=dev-dev-11913

 

Returns the Conditions with resolved status for patient 11913.

 

code

Corresponds to

Condition.code

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?code=10725009

 

Returns the Conditions with diagnosis code of 10725009.

 

name

Corresponds to

human-readable Condition descriptions in the database

Search

contains

Example

https://sandbox.pai.healthcare/preview/fhir/Condition?name=diabetes

 

Returns the Conditions with diagnosis name of diabetes.