This page is part of the FHIR Specification (v5.0.0-snapshot3: R5 Snapshot #3, to support Connectathon 32). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
Patient Care Work Group | Maturity Level: 3 | Trial Use | Security Category: Patient | Compartments: Encounter, Patient, Practitioner, RelatedPerson |
A clinical condition, problem, diagnosis, or other event, situation, issue, or clinical concept that has risen to a level of concern.
This resource is used to record detailed information about a condition, problem, diagnosis, or other event, situation, issue, or clinical concept that has risen to a level of concern. The condition could be a point in time diagnosis in context of an encounter, it could be an item on the practitioner’s Problem List, or it could be a concern that doesn’t exist on the practitioner’s Problem List. Often times, a condition is about a clinician's assessment and assertion of a particular aspect of a patient's state of health. It can be used to record information about a disease/illness identified from application of clinical reasoning over the pathologic and pathophysiologic findings (diagnosis), or identification of health issues/situations that a practitioner considers harmful, potentially harmful and may be investigated and managed (problem), or other health issue/situation that may require ongoing monitoring and/or management (health issue/concern).
The condition resource may be used to record a certain health state of a patient which does not normally present a negative outcome, e.g. pregnancy. The condition resource may be used to record a condition following a procedure, such as the condition of Amputee-BKA following an amputation procedure.
While conditions are frequently a result of a clinician's assessment and assertion of a particular aspect of a patient's state of health, conditions can also be expressed by the patient, related person, or any care team member. A clinician may have a concern about a patient condition (e.g. anorexia) that the patient is not concerned about. Likewise, the patient may have a condition (e.g. hair loss) that does not rise to the level of importance such that it belongs on a practitioner’s Problem List.
For example, each of the following conditions could rise to the level of importance such that it belongs on a problem or concern list due to its direct or indirect impact on the patient’s health:
These examples may also be represented using other resources, such as FamilyMemberHistory, Observation, RiskAssessment, or Procedure.
The condition resource may be referenced by other resources as "reasons" for an action (e.g. MedicationRequest, Procedure, ServiceRequest, etc.)
This resource is not typically used to record information about subjective and objective information that might lead to the recording of a Condition resource. Such signs and symptoms are typically captured using the Observation resource; although in some cases a persistent symptom, e.g. fever, headache may be captured as a condition before a definitive diagnosis can be discerned by a clinician. In an inpatient scenario, a nursing problem list may document symptoms (such as respiratory alteration) as conditions if they are the focus of care provision. It became a problem because the nurse (clinician) wants to manage it. By contrast, headache may be captured as an Observation when it contributes to the establishment of a meningitis Condition.
Use the Observation resource when a symptom is resolved without long term management, tracking, or when a symptom contributes to the establishment of a condition.
Use Condition when a symptom requires long term management, tracking, or is used as a proxy for a diagnosis or problem that is not yet determined.
Note that a Condition represents an instance of a condition, not the categorical patient state. This can be a subtle distinction for systemic conditions, but it is easier to see with conditions that can happen more than once, e.g. refuting one record of a wound does not mean that the patient does not have any other wounds, and resolving one case of otitis media does not rule out recurrence. An observation that the patient doesn't have any wounds means the patient doesn't have any wounds at that point in time.
When the diagnosis is related to an allergy or intolerance, the Condition and AllergyIntolerance resources can both be used. However, to be actionable for decision support, using Condition alone is not sufficient as the allergy or intolerance condition needs to be represented as an AllergyIntolerance.
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Condition | TU | DomainResource | Detailed information about conditions, problems or diagnoses + Warning: If category is problems list item, the clinicalStatus should not be unknown + Rule: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission. Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | Σ | 0..* | Identifier | External Ids for this condition |
clinicalStatus | ?!ΣC | 1..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved | unknown Condition Clinical Status Codes (Required) |
verificationStatus | ?!Σ | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error ConditionVerificationStatus (Required) |
category | C | 0..* | CodeableConcept | problem-list-item | encounter-diagnosis Condition Category Codes (Preferred) |
severity | 0..1 | CodeableConcept | Subjective severity of condition Condition/Diagnosis Severity (Preferred) | |
code | Σ | 0..1 | CodeableConcept | Identification of the condition, problem or diagnosis Condition/Problem/Diagnosis Codes (Example) |
bodySite | Σ | 0..* | CodeableConcept | Anatomical location, if relevant SNOMED CT Body Structures (Example) |
subject | Σ | 1..1 | Reference(Patient | Group) | Who has the condition? |
encounter | Σ | 0..1 | Reference(Encounter) | The Encounter during which this Condition was created |
onset[x] | Σ | 0..1 | Estimated or actual date, date-time, or age | |
onsetDateTime | dateTime | |||
onsetAge | Age | |||
onsetPeriod | Period | |||
onsetRange | Range | |||
onsetString | string | |||
abatement[x] | C | 0..1 | When in resolution/remission | |
abatementDateTime | dateTime | |||
abatementAge | Age | |||
abatementPeriod | Period | |||
abatementRange | Range | |||
abatementString | string | |||
recordedDate | Σ | 0..1 | dateTime | Date condition was first recorded |
participant | Σ | 0..* | BackboneElement | Who or what participated in the activities related to the condition and how they were involved |
function | Σ | 0..1 | CodeableConcept | Type of involvement ParticipationRoleType (Extensible) |
actor | Σ | 1..1 | Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization | CareTeam) | Who or what participated in the activities related to the condition |
stage | CTU | 0..* | BackboneElement | Stage/grade, usually assessed formally + Rule: Stage SHALL have summary or assessment |
summary | C | 0..1 | CodeableConcept | Simple summary (disease specific) Condition Stage (Example) |
assessment | C | 0..* | Reference(ClinicalImpression | DiagnosticReport | Observation) | Formal record of assessment |
type | 0..1 | CodeableConcept | Kind of staging Condition Stage Type (Example) | |
evidence | ΣTU | 0..* | CodeableReference(Any) | Supporting evidence for the verification status SNOMED CT Clinical Findings (Example) |
note | 0..* | Annotation | Additional information about the Condition | |
Documentation for this format |
See the Extensions for this resource
UML Diagram (Legend)
XML Template
<Condition xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External Ids for this condition --></identifier> <clinicalStatus><!-- I 1..1 CodeableConcept active | recurrence | relapse | inactive | remission | resolved | unknown --></clinicalStatus> <verificationStatus><!-- 0..1 CodeableConcept unconfirmed | provisional | differential | confirmed | refuted | entered-in-error --></verificationStatus> <category><!-- I 0..* CodeableConcept problem-list-item | encounter-diagnosis --></category> <severity><!-- 0..1 CodeableConcept Subjective severity of condition --></severity> <code><!-- 0..1 CodeableConcept Identification of the condition, problem or diagnosis --></code> <bodySite><!-- 0..* CodeableConcept Anatomical location, if relevant --></bodySite> <subject><!-- 1..1 Reference(Group|Patient) Who has the condition? --></subject> <encounter><!-- 0..1 Reference(Encounter) The Encounter during which this Condition was created --></encounter> <onset[x]><!-- 0..1 dateTime|Age|Period|Range|string Estimated or actual date, date-time, or age --></onset[x]> <abatement[x]><!-- I 0..1 dateTime|Age|Period|Range|string When in resolution/remission --></abatement[x]> <recordedDate value="[dateTime]"/><!-- 0..1 Date condition was first recorded --> <participant> <!-- 0..* Who or what participated in the activities related to the condition and how they were involved --> <function><!-- 0..1 CodeableConcept Type of involvement --></function> <actor><!-- 1..1 Reference(CareTeam|Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what participated in the activities related to the condition --></actor> </participant> <stage> <!-- 0..* Stage/grade, usually assessed formally --> <summary><!-- I 0..1 CodeableConcept Simple summary (disease specific) --></summary> <assessment><!-- I 0..* Reference(ClinicalImpression|DiagnosticReport|Observation) Formal record of assessment --></assessment> <type><!-- 0..1 CodeableConcept Kind of staging --></type> </stage> <evidence><!-- 0..* CodeableReference(Any) Supporting evidence for the verification status --></evidence> <note><!-- 0..* Annotation Additional information about the Condition --></note> </Condition>
JSON Template
{ "resourceType" : "Condition", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External Ids for this condition "clinicalStatus" : { CodeableConcept }, // I R! active | recurrence | relapse | inactive | remission | resolved | unknown "verificationStatus" : { CodeableConcept }, // unconfirmed | provisional | differential | confirmed | refuted | entered-in-error "category" : [{ CodeableConcept }], // I problem-list-item | encounter-diagnosis "severity" : { CodeableConcept }, // Subjective severity of condition "code" : { CodeableConcept }, // Identification of the condition, problem or diagnosis "bodySite" : [{ CodeableConcept }], // Anatomical location, if relevant "subject" : { Reference(Group|Patient) }, // R! Who has the condition? "encounter" : { Reference(Encounter) }, // The Encounter during which this Condition was created // onset[x]: Estimated or actual date, date-time, or age. One of these 5: "onsetDateTime" : "<dateTime>", "onsetAge" : { Age }, "onsetPeriod" : { Period }, "onsetRange" : { Range }, "onsetString" : "<string>", // abatement[x]: When in resolution/remission. One of these 5: "abatementDateTime" : "<dateTime>", "abatementAge" : { Age }, "abatementPeriod" : { Period }, "abatementRange" : { Range }, "abatementString" : "<string>", "recordedDate" : "<dateTime>", // Date condition was first recorded "participant" : [{ // Who or what participated in the activities related to the condition and how they were involved "function" : { CodeableConcept }, // Type of involvement "actor" : { Reference(CareTeam|Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) } // R! Who or what participated in the activities related to the condition }], "stage" : [{ // Stage/grade, usually assessed formally "summary" : { CodeableConcept }, // I Simple summary (disease specific) "assessment" : [{ Reference(ClinicalImpression|DiagnosticReport|Observation) }], // I Formal record of assessment "type" : { CodeableConcept } // Kind of staging }], "evidence" : [{ CodeableReference(Any) }], // Supporting evidence for the verification status "note" : [{ Annotation }] // Additional information about the Condition }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Condition; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Condition.identifier [ Identifier ], ... ; # 0..* External Ids for this condition fhir:Condition.clinicalStatus [ CodeableConcept ]; # 1..1 I active | recurrence | relapse | inactive | remission | resolved | unknown fhir:Condition.verificationStatus [ CodeableConcept ]; # 0..1 unconfirmed | provisional | differential | confirmed | refuted | entered-in-error fhir:Condition.category [ CodeableConcept ], ... ; # 0..* I problem-list-item | encounter-diagnosis fhir:Condition.severity [ CodeableConcept ]; # 0..1 Subjective severity of condition fhir:Condition.code [ CodeableConcept ]; # 0..1 Identification of the condition, problem or diagnosis fhir:Condition.bodySite [ CodeableConcept ], ... ; # 0..* Anatomical location, if relevant fhir:Condition.subject [ Reference(Group|Patient) ]; # 1..1 Who has the condition? fhir:Condition.encounter [ Reference(Encounter) ]; # 0..1 The Encounter during which this Condition was created # Condition.onset[x] : 0..1 Estimated or actual date, date-time, or age. One of these 5 fhir:Condition.onsetDateTime [ dateTime ] fhir:Condition.onsetAge [ Age ] fhir:Condition.onsetPeriod [ Period ] fhir:Condition.onsetRange [ Range ] fhir:Condition.onsetString [ string ] # Condition.abatement[x] : 0..1 I When in resolution/remission. One of these 5 fhir:Condition.abatementDateTime [ dateTime ] fhir:Condition.abatementAge [ Age ] fhir:Condition.abatementPeriod [ Period ] fhir:Condition.abatementRange [ Range ] fhir:Condition.abatementString [ string ] fhir:Condition.recordedDate [ dateTime ]; # 0..1 Date condition was first recorded fhir:Condition.participant [ # 0..* Who or what participated in the activities related to the condition and how they were involved fhir:Condition.participant.function [ CodeableConcept ]; # 0..1 Type of involvement fhir:Condition.participant.actor [ Reference(CareTeam|Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 1..1 Who or what participated in the activities related to the condition ], ...; fhir:Condition.stage [ # 0..* Stage/grade, usually assessed formally fhir:Condition.stage.summary [ CodeableConcept ]; # 0..1 I Simple summary (disease specific) fhir:Condition.stage.assessment [ Reference(ClinicalImpression|DiagnosticReport|Observation) ], ... ; # 0..* I Formal record of assessment fhir:Condition.stage.type [ CodeableConcept ]; # 0..1 Kind of staging ], ...; fhir:Condition.evidence [ CodeableReference(Any) ], ... ; # 0..* Supporting evidence for the verification status fhir:Condition.note [ Annotation ], ... ; # 0..* Additional information about the Condition ]
Changes since R4
Condition | |
Condition.clinicalStatus |
|
Condition.category |
|
Condition.participant |
|
Condition.participant.function |
|
Condition.participant.actor |
|
Condition.evidence |
|
Condition.recorder |
|
Condition.asserter |
|
Condition.evidence.code |
|
Condition.evidence.detail |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 12 tests that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Condition | TU | DomainResource | Detailed information about conditions, problems or diagnoses + Warning: If category is problems list item, the clinicalStatus should not be unknown + Rule: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission. Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | Σ | 0..* | Identifier | External Ids for this condition |
clinicalStatus | ?!ΣC | 1..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved | unknown Condition Clinical Status Codes (Required) |
verificationStatus | ?!Σ | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error ConditionVerificationStatus (Required) |
category | C | 0..* | CodeableConcept | problem-list-item | encounter-diagnosis Condition Category Codes (Preferred) |
severity | 0..1 | CodeableConcept | Subjective severity of condition Condition/Diagnosis Severity (Preferred) | |
code | Σ | 0..1 | CodeableConcept | Identification of the condition, problem or diagnosis Condition/Problem/Diagnosis Codes (Example) |
bodySite | Σ | 0..* | CodeableConcept | Anatomical location, if relevant SNOMED CT Body Structures (Example) |
subject | Σ | 1..1 | Reference(Patient | Group) | Who has the condition? |
encounter | Σ | 0..1 | Reference(Encounter) | The Encounter during which this Condition was created |
onset[x] | Σ | 0..1 | Estimated or actual date, date-time, or age | |
onsetDateTime | dateTime | |||
onsetAge | Age | |||
onsetPeriod | Period | |||
onsetRange | Range | |||
onsetString | string | |||
abatement[x] | C | 0..1 | When in resolution/remission | |
abatementDateTime | dateTime | |||
abatementAge | Age | |||
abatementPeriod | Period | |||
abatementRange | Range | |||
abatementString | string | |||
recordedDate | Σ | 0..1 | dateTime | Date condition was first recorded |
participant | Σ | 0..* | BackboneElement | Who or what participated in the activities related to the condition and how they were involved |
function | Σ | 0..1 | CodeableConcept | Type of involvement ParticipationRoleType (Extensible) |
actor | Σ | 1..1 | Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization | CareTeam) | Who or what participated in the activities related to the condition |
stage | CTU | 0..* | BackboneElement | Stage/grade, usually assessed formally + Rule: Stage SHALL have summary or assessment |
summary | C | 0..1 | CodeableConcept | Simple summary (disease specific) Condition Stage (Example) |
assessment | C | 0..* | Reference(ClinicalImpression | DiagnosticReport | Observation) | Formal record of assessment |
type | 0..1 | CodeableConcept | Kind of staging Condition Stage Type (Example) | |
evidence | ΣTU | 0..* | CodeableReference(Any) | Supporting evidence for the verification status SNOMED CT Clinical Findings (Example) |
note | 0..* | Annotation | Additional information about the Condition | |
Documentation for this format |
See the Extensions for this resource
XML Template
<Condition xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External Ids for this condition --></identifier> <clinicalStatus><!-- I 1..1 CodeableConcept active | recurrence | relapse | inactive | remission | resolved | unknown --></clinicalStatus> <verificationStatus><!-- 0..1 CodeableConcept unconfirmed | provisional | differential | confirmed | refuted | entered-in-error --></verificationStatus> <category><!-- I 0..* CodeableConcept problem-list-item | encounter-diagnosis --></category> <severity><!-- 0..1 CodeableConcept Subjective severity of condition --></severity> <code><!-- 0..1 CodeableConcept Identification of the condition, problem or diagnosis --></code> <bodySite><!-- 0..* CodeableConcept Anatomical location, if relevant --></bodySite> <subject><!-- 1..1 Reference(Group|Patient) Who has the condition? --></subject> <encounter><!-- 0..1 Reference(Encounter) The Encounter during which this Condition was created --></encounter> <onset[x]><!-- 0..1 dateTime|Age|Period|Range|string Estimated or actual date, date-time, or age --></onset[x]> <abatement[x]><!-- I 0..1 dateTime|Age|Period|Range|string When in resolution/remission --></abatement[x]> <recordedDate value="[dateTime]"/><!-- 0..1 Date condition was first recorded --> <participant> <!-- 0..* Who or what participated in the activities related to the condition and how they were involved --> <function><!-- 0..1 CodeableConcept Type of involvement --></function> <actor><!-- 1..1 Reference(CareTeam|Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what participated in the activities related to the condition --></actor> </participant> <stage> <!-- 0..* Stage/grade, usually assessed formally --> <summary><!-- I 0..1 CodeableConcept Simple summary (disease specific) --></summary> <assessment><!-- I 0..* Reference(ClinicalImpression|DiagnosticReport|Observation) Formal record of assessment --></assessment> <type><!-- 0..1 CodeableConcept Kind of staging --></type> </stage> <evidence><!-- 0..* CodeableReference(Any) Supporting evidence for the verification status --></evidence> <note><!-- 0..* Annotation Additional information about the Condition --></note> </Condition>
JSON Template
{ "resourceType" : "Condition", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External Ids for this condition "clinicalStatus" : { CodeableConcept }, // I R! active | recurrence | relapse | inactive | remission | resolved | unknown "verificationStatus" : { CodeableConcept }, // unconfirmed | provisional | differential | confirmed | refuted | entered-in-error "category" : [{ CodeableConcept }], // I problem-list-item | encounter-diagnosis "severity" : { CodeableConcept }, // Subjective severity of condition "code" : { CodeableConcept }, // Identification of the condition, problem or diagnosis "bodySite" : [{ CodeableConcept }], // Anatomical location, if relevant "subject" : { Reference(Group|Patient) }, // R! Who has the condition? "encounter" : { Reference(Encounter) }, // The Encounter during which this Condition was created // onset[x]: Estimated or actual date, date-time, or age. One of these 5: "onsetDateTime" : "<dateTime>", "onsetAge" : { Age }, "onsetPeriod" : { Period }, "onsetRange" : { Range }, "onsetString" : "<string>", // abatement[x]: When in resolution/remission. One of these 5: "abatementDateTime" : "<dateTime>", "abatementAge" : { Age }, "abatementPeriod" : { Period }, "abatementRange" : { Range }, "abatementString" : "<string>", "recordedDate" : "<dateTime>", // Date condition was first recorded "participant" : [{ // Who or what participated in the activities related to the condition and how they were involved "function" : { CodeableConcept }, // Type of involvement "actor" : { Reference(CareTeam|Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) } // R! Who or what participated in the activities related to the condition }], "stage" : [{ // Stage/grade, usually assessed formally "summary" : { CodeableConcept }, // I Simple summary (disease specific) "assessment" : [{ Reference(ClinicalImpression|DiagnosticReport|Observation) }], // I Formal record of assessment "type" : { CodeableConcept } // Kind of staging }], "evidence" : [{ CodeableReference(Any) }], // Supporting evidence for the verification status "note" : [{ Annotation }] // Additional information about the Condition }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Condition; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Condition.identifier [ Identifier ], ... ; # 0..* External Ids for this condition fhir:Condition.clinicalStatus [ CodeableConcept ]; # 1..1 I active | recurrence | relapse | inactive | remission | resolved | unknown fhir:Condition.verificationStatus [ CodeableConcept ]; # 0..1 unconfirmed | provisional | differential | confirmed | refuted | entered-in-error fhir:Condition.category [ CodeableConcept ], ... ; # 0..* I problem-list-item | encounter-diagnosis fhir:Condition.severity [ CodeableConcept ]; # 0..1 Subjective severity of condition fhir:Condition.code [ CodeableConcept ]; # 0..1 Identification of the condition, problem or diagnosis fhir:Condition.bodySite [ CodeableConcept ], ... ; # 0..* Anatomical location, if relevant fhir:Condition.subject [ Reference(Group|Patient) ]; # 1..1 Who has the condition? fhir:Condition.encounter [ Reference(Encounter) ]; # 0..1 The Encounter during which this Condition was created # Condition.onset[x] : 0..1 Estimated or actual date, date-time, or age. One of these 5 fhir:Condition.onsetDateTime [ dateTime ] fhir:Condition.onsetAge [ Age ] fhir:Condition.onsetPeriod [ Period ] fhir:Condition.onsetRange [ Range ] fhir:Condition.onsetString [ string ] # Condition.abatement[x] : 0..1 I When in resolution/remission. One of these 5 fhir:Condition.abatementDateTime [ dateTime ] fhir:Condition.abatementAge [ Age ] fhir:Condition.abatementPeriod [ Period ] fhir:Condition.abatementRange [ Range ] fhir:Condition.abatementString [ string ] fhir:Condition.recordedDate [ dateTime ]; # 0..1 Date condition was first recorded fhir:Condition.participant [ # 0..* Who or what participated in the activities related to the condition and how they were involved fhir:Condition.participant.function [ CodeableConcept ]; # 0..1 Type of involvement fhir:Condition.participant.actor [ Reference(CareTeam|Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 1..1 Who or what participated in the activities related to the condition ], ...; fhir:Condition.stage [ # 0..* Stage/grade, usually assessed formally fhir:Condition.stage.summary [ CodeableConcept ]; # 0..1 I Simple summary (disease specific) fhir:Condition.stage.assessment [ Reference(ClinicalImpression|DiagnosticReport|Observation) ], ... ; # 0..* I Formal record of assessment fhir:Condition.stage.type [ CodeableConcept ]; # 0..1 Kind of staging ], ...; fhir:Condition.evidence [ CodeableReference(Any) ], ... ; # 0..* Supporting evidence for the verification status fhir:Condition.note [ Annotation ], ... ; # 0..* Additional information about the Condition ]
Changes since Release 4
Condition | |
Condition.clinicalStatus |
|
Condition.category |
|
Condition.participant |
|
Condition.participant.function |
|
Condition.participant.actor |
|
Condition.evidence |
|
Condition.recorder |
|
Condition.asserter |
|
Condition.evidence.code |
|
Condition.evidence.detail |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 12 tests that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis
Path | Definition | Type | Reference |
---|---|---|---|
Condition.clinicalStatus | Preferred value set for Condition Clinical Status. | Required | ConditionClinicalStatusCodes |
Condition.verificationStatus | The verification status to support or decline the clinical status of the condition or diagnosis. | Required | ConditionVerificationStatus |
Condition.category | Preferred value set for Condition Categories. | Preferred | ConditionCategoryCodes |
Condition.severity | Preferred value set for Condition/Diagnosis severity grading. | Preferred | ConditionDiagnosisSeverity |
Condition.code | Example value set for Condition/Problem/Diagnosis codes. | Example | ConditionProblemDiagnosisCodes |
Condition.bodySite | This value set includes all codes from SNOMED CT where concept is-a 442083009 (Anatomical or acquired body site (body structure)). | Example | SNOMEDCTBodyStructures |
Condition.participant.function | This FHIR value set is comprised of Actor participation Type codes, which can be used to value FHIR agents, actors, and other role elements. The codes are intended to express how the agent participated in some activity. Sometimes refered to the agent functional-role relative to the activity. | Extensible | ParticipationRoleType |
Condition.stage.summary | Example value set for stages of cancer and other conditions. | Example | ConditionStage |
Condition.stage.type | Example value set for the type of stages of cancer and other conditions | Example | ConditionStageType |
Condition.evidence | This value set includes all the "Clinical finding" SNOMED CT codes - concepts where concept is-a 404684003 (Clinical finding (finding)). | Example | SNOMEDCTClinicalFindings |
UniqueKey | Level | Location | Description | Expression |
con-1 | Rule | Condition.stage | Stage SHALL have summary or assessment | summary.exists() or assessment.exists() |
con-2 | Warning | (base) | If category is problems list item, the clinicalStatus should not be unknown | category.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-category' and code='problem-list-item').exists() implies clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and code='unknown').exists().not() |
con-3 | Rule | (base) | If condition is abated, then clinicalStatus must be either inactive, resolved, or remission. | abatement.exists() implies (clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='inactive' or code='resolved' or code='remission')).exists()) |
Many of the code systems used for coding conditions will provide codes that define not only the condition itself, but may also specify a particular stage, location, or causality as part of the code. This is particularly true if SNOMED CT is used for the condition, and especially if expressions are allowed.
The Condition.code may also include such concepts as "history of X" and "good health", where it is useful or appropriate to make such assertions. It can also be used to capture "risk of" and "fear of", in addition to physical conditions, as well as "no known problems" or "negated" conditions (e.g., "no X" or "no history of X" - see the following section for "No Known Problems" and Negated Conditions).
When the Condition.code specifies additional properties of the condition, the other properties are not given a value - instead, the value must be understood from the Condition.code.
Conditions/Problems Not Reviewed, Not Asked
When a sending system does not have any information about conditions/problems being reviewed or the statement is about conditions/problems not yet being asked, then the List resource should be used to indicate the List.emptyReason.code="notasked".
Conditions/Problems Reviewed, None Identified
Systems may use the List.emptyReason when a statement is about the full scope of the list (i.e. the patient has no conditions/problems of any type). However, it may be preferred to use a code for "no known problems" (e.g., SNOMED CT: 160245001 |No current problems or disability (situation)|), so that all condition/problem data will be available and queryable from Condition resource instances.
Also note that care should be used when adding new Condition resources to a list to ensure that any negation statements that are voided by the addition of a new record are removed from the list. E.g. If the list contains a "no known problems" record and you add a "diabetes" condition record, then be sure that you remove the "no known problems" record.
Note to Implementers: There are two primary ways of reporting "no known problems" in the current specification: using the CodeableConcept, as described above, or using the List resource with emptyReason. During the STU period, feedback is sought regarding the preferred approach.
Provide feedback here .
Patient Denies Condition
When the patient denies a condition, that can be annotated in the Condition.note element.
Generally, electronic records do not contain assertions of conditions that a patient does not have. There are however two exceptions:
The Condition.evidence provides the basis for whatever is present in Condition.code.
A range is used to communicate age period of subject at time of abatement.
If the data enterer is different from the asserter and needs to be known, this could be captured using a Provenance instance pointing to the Condition. For example, it is possible that a nurse records the condition on behalf of a physician. The physician is taking responsibility, despite the nurse entering it into the medical record.
The Condition.stage and Condition.clinicalStatus may have interdependencies. For example, some "stages" of cancer, etc. will be different for a remission than for the initial occurrence.
To represent the role of the diagnosis within an encounter, such as admission diagnosis or discharge diagnosis, use Encounter.diagnosis.role.
To represent the numeric ranking of the diagnosis within an encounter, such as primary, secondary, or tertiary, use Encounter.diagnosis.rank.
A known issue exists with circular references between Condition and ClinicalImpression, which is due to the low maturity level of ClinicalImpression. The Patient Care work group intends to address this issue when ClinicalImpression is considered substantially complete and ready for implementation.
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
abatement-age | quantity | Abatement as age or age range | Condition.abatement.ofType(Age) | Condition.abatement.ofType(Range) | |
abatement-date | date | Date-related abatements (dateTime and period) | Condition.abatement.ofType(dateTime) | Condition.abatement.ofType(Period) | |
abatement-string | string | Abatement as a string | Condition.abatement.ofType(string) | |
body-site | token | Anatomical location, if relevant | Condition.bodySite | |
category | token | The category of the condition | Condition.category | |
clinical-status | token | The clinical status of the condition | Condition.clinicalStatus | |
code | token | Code for the condition | Condition.code | 13 Resources |
encounter | reference | The Encounter during which this Condition was created | Condition.encounter (Encounter) | |
evidence | token | Manifestation/symptom | Condition.evidence.concept | |
evidence-detail | reference | Supporting information found elsewhere | Condition.evidence.reference | |
identifier | token | A unique identifier of the condition record | Condition.identifier | 30 Resources |
onset-age | quantity | Onsets as age or age range | Condition.onset.ofType(Age) | Condition.onset.ofType(Range) | |
onset-date | date | Date related onsets (dateTime and Period) | Condition.onset.ofType(dateTime) | Condition.onset.ofType(Period) | |
onset-info | string | Onsets as a string | Condition.onset.ofType(string) | |
participant-actor | reference | Who or what participated in the activities related to the condition | Condition.participant.actor (Practitioner, Organization, CareTeam, Device, Patient, PractitionerRole, RelatedPerson) | |
participant-function | token | Type of involvement of the actor in the activities related to the condition | Condition.participant.function | |
patient | reference | Who has the condition? | Condition.subject.where(resolve() is Patient) (Patient) | 33 Resources |
recorded-date | date | Date record was first recorded | Condition.recordedDate | |
severity | token | The severity of the condition | Condition.severity | |
stage | token | Simple summary (disease specific) | Condition.stage.summary | |
subject | reference | Who has the condition? | Condition.subject (Group, Patient) | |
verification-status | token | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error | Condition.verificationStatus |