This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version. For a full list of available versions, see the Directory of published versions

14.9 Resource ConditionDefinition - Content

Patient Care icon

Work Group

Maturity Level: 0

Trial Use

Security Category: Anonymous

Compartments: No defined compartments

A definition of a condition and information relevant to managing it.

14.9.1 Scope and Usage

A condition definition defines a set of system properties for a particular condition.

It is important to understand the condition definition resource is not intended to be used to define the underlying biological or ontological basis for the condition; instead the focus is on how the condition is identified, managed, and treated.

14.9.2 Boundaries and Relationships

Conditions may have a matching condition definition, but need not do so
Condition definitions may identify observations and signs (including, but not limited to) lab tests that are indicative of the condition
Condition definitions often identify ongoing observations to prioritize when viewing the chart of patients with the conditions
Condition definitions may identify applicable care plans

14.9.3 Background and Context

One frequent criticism of information systems in healthcare is that they do not adapt well to changing context, particularly the context of what is specifically wrong. A typical institution will have 20-30,000 different kinds of observational data, but only a small portion of these are relevant to any particular condition. Information systems supporting clinical care provision are increasingly investigating the use of AI, but ConditionDefinition provides a simple way to help the system be more adaptive.

14.9.4 References to this Resource

No references for this Resource.

Structure

Name	Flags	Card.	Type	Description & Constraints
ConditionDefinition	TU		DomainResource	A definition of a condition + Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension Interfaces Implemented: MetadataResource
url	Σ C	0..1	uri	Canonical identifier for this condition definition, represented as a URI (globally unique) + Warning: URL should not contain \| or # - these characters make processing canonical references problematic
identifier	Σ	0..*	Identifier	Additional identifier for the condition definition
version	Σ	0..1	string	Business version of the condition definition
versionAlgorithm[x]	Σ	0..1		How to compare versions Binding: Version Algorithm (Extensible)
versionAlgorithmString			string
versionAlgorithmCoding			Coding
name	Σ C	0..1	string	Name for this condition definition (computer friendly)
title	Σ T	0..1	string	Name for this condition definition (human friendly)
subtitle		0..1	string	Subordinate title of the event definition
status	?!Σ	1..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (Required)
experimental	Σ	0..1	boolean	For testing purposes, not real usage
date	Σ	0..1	dateTime	Date last changed
publisher	Σ T	0..1	string	Name of the publisher/steward (organization or individual)
contact	Σ	0..*	ContactDetail	Contact details for the publisher
description	T	0..1	markdown	Natural language description of the condition definition
useContext	Σ	0..*	UsageContext	The context that the content is intended to support
jurisdiction	Σ XD	0..*	CodeableConcept	Intended jurisdiction for condition definition (if applicable) Binding: Jurisdiction ValueSet (Extensible)
code	Σ	1..1	CodeableConcept	Identification of the condition, problem or diagnosis Binding: Condition/Problem/Diagnosis Codes (Example)
severity	Σ	0..1	CodeableConcept	Subjective severity of condition Binding: Condition/Diagnosis Severity (Preferred)
bodySite	Σ	0..1	CodeableConcept	Anatomical location, if relevant Binding: SNOMED CT Body Structures (Example)
stage	Σ	0..1	CodeableConcept	Stage/grade, usually assessed formally Binding: Condition Stage (Example)
hasSeverity		0..1	boolean	Whether Severity is appropriate
hasBodySite		0..1	boolean	Whether bodySite is appropriate
hasStage		0..1	boolean	Whether stage is appropriate
definition		0..*	uri	Formal Definition for the condition
observation		0..*	BackboneElement	Observations particularly relevant to this condition
category		0..1	CodeableConcept	Category that is relevant Binding: Observation Category Codes (Preferred)
code		0..1	CodeableConcept	Code for relevant Observation Binding: LOINC Codes (Example)
medication		0..*	BackboneElement	Medications particularly relevant for this condition
category		0..1	CodeableConcept	Category that is relevant Binding: Medication request category codes (Example)
code		0..1	CodeableConcept	Code for relevant Medication Binding: SNOMED CT Medication Codes (Example)
precondition		0..*	BackboneElement	Observation that suggets this condition
type		1..1	code	sensitive \| specific Binding: Condition Precondition Type (Required)
code		1..1	CodeableConcept	Code for relevant Observation Binding: LOINC Codes (Example)
value[x]		0..1		Value of Observation
valueCodeableConcept			CodeableConcept
valueQuantity			Quantity
team		0..*	Reference(CareTeam)	Appropriate team for this condition
questionnaire		0..*	BackboneElement	Questionnaire for this condition
purpose		1..1	code	preadmit \| diff-diagnosis \| outcome Binding: Condition Questionnaire Purpose (Required)
reference		1..1	Reference(Questionnaire)	Specific Questionnaire
plan		0..*	BackboneElement	Plan that is appropriate
role		0..1	CodeableConcept	Use for the plan
reference		1..1	Reference(PlanDefinition)	The actual plan
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<ConditionDefinition xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this condition definition, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Additional identifier for the condition definition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the condition definition -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this condition definition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this condition definition (human friendly) -->
 <subtitle value="[string]"/><!-- 0..1 Subordinate title of the event definition -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the condition definition -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for condition definition (if applicable) --></jurisdiction>
 <code><!-- 1..1 CodeableConcept Identification of the condition, problem or diagnosis --></code>
 <severity><!-- 0..1 CodeableConcept Subjective severity of condition --></severity>
 <bodySite><!-- 0..1 CodeableConcept Anatomical location, if relevant --></bodySite>
 <stage><!-- 0..1 CodeableConcept Stage/grade, usually assessed formally --></stage>
 <hasSeverity value="[boolean]"/><!-- 0..1 Whether Severity is appropriate -->
 <hasBodySite value="[boolean]"/><!-- 0..1 Whether bodySite is appropriate -->
 <hasStage value="[boolean]"/><!-- 0..1 Whether stage is appropriate -->
 <definition value="[uri]"/><!-- 0..* Formal Definition for the condition -->
 <observation>  <!-- 0..* Observations particularly relevant to this condition -->
  <category><!-- 0..1 CodeableConcept Category that is relevant --></category>
  <code><!-- 0..1 CodeableConcept Code for relevant Observation --></code>
 </observation>
 <medication>  <!-- 0..* Medications particularly relevant for this condition -->
  <category><!-- 0..1 CodeableConcept Category that is relevant  --></category>
  <code><!-- 0..1 CodeableConcept Code for relevant Medication --></code>
 </medication>
 <precondition>  <!-- 0..* Observation that suggets this condition -->
  <type value="[code]"/><!-- 1..1 sensitive | specific -->
  <code><!-- 1..1 CodeableConcept Code for relevant Observation --></code>
  <value[x]><!-- 0..1 CodeableConcept|Quantity Value of Observation --></value[x]>
 </precondition>
 <team><!-- 0..* Reference(CareTeam) Appropriate team for this condition --></team>
 <questionnaire>  <!-- 0..* Questionnaire for this condition -->
  <purpose value="[code]"/><!-- 1..1 preadmit | diff-diagnosis | outcome -->
  <reference><!-- 1..1 Reference(Questionnaire) Specific Questionnaire --></reference>
 </questionnaire>
 <plan>  <!-- 0..* Plan that is appropriate -->
  <role><!-- 0..1 CodeableConcept Use for the plan --></role>
  <reference><!-- 1..1 Reference(PlanDefinition) The actual plan --></reference>
 </plan>
</ConditionDefinition>

JSON Template

{
  "resourceType" : "ConditionDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this condition definition, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the condition definition
  "version" : "<string>", // Business version of the condition definition
  // versionAlgorithm[x]: How to compare versions. One of these 2:
  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this condition definition (computer friendly)
  "title" : "<string>", // Name for this condition definition (human friendly)
  "subtitle" : "<string>", // Subordinate title of the event definition
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the condition definition
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for condition definition (if applicable)
  "code" : { CodeableConcept }, // R!  Identification of the condition, problem or diagnosis
  "severity" : { CodeableConcept }, // Subjective severity of condition
  "bodySite" : { CodeableConcept }, // Anatomical location, if relevant
  "stage" : { CodeableConcept }, // Stage/grade, usually assessed formally
  "hasSeverity" : <boolean>, // Whether Severity is appropriate
  "hasBodySite" : <boolean>, // Whether bodySite is appropriate
  "hasStage" : <boolean>, // Whether stage is appropriate
  "definition" : ["<uri>"], // Formal Definition for the condition
  "observation" : [{ // Observations particularly relevant to this condition
    "category" : { CodeableConcept }, // Category that is relevant
    "code" : { CodeableConcept } // Code for relevant Observation
  }],
  "medication" : [{ // Medications particularly relevant for this condition
    "category" : { CodeableConcept }, // Category that is relevant 
    "code" : { CodeableConcept } // Code for relevant Medication
  }],
  "precondition" : [{ // Observation that suggets this condition
    "type" : "<code>", // R!  sensitive | specific
    "code" : { CodeableConcept }, // R!  Code for relevant Observation
    // value[x]: Value of Observation. One of these 2:
    "valueCodeableConcept" : { CodeableConcept },
    "valueQuantity" : { Quantity }
  }],
  "team" : [{ Reference(CareTeam) }], // Appropriate team for this condition
  "questionnaire" : [{ // Questionnaire for this condition
    "purpose" : "<code>", // R!  preadmit | diff-diagnosis | outcome
    "reference" : { Reference(Questionnaire) } // R!  Specific Questionnaire
  }],
  "plan" : [{ // Plan that is appropriate
    "role" : { CodeableConcept }, // Use for the plan
    "reference" : { Reference(PlanDefinition) } // R!  The actual plan
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:ConditionDefinition;
  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:url [ uri ] ; # 0..1 Canonical identifier for this condition definition, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the condition definition
  fhir:version [ string ] ; # 0..1 Business version of the condition definition
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this condition definition (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this condition definition (human friendly)
  fhir:subtitle [ string ] ; # 0..1 Subordinate title of the event definition
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the condition definition
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for condition definition (if applicable)
  fhir:code [ CodeableConcept ] ; # 1..1 Identification of the condition, problem or diagnosis
  fhir:severity [ CodeableConcept ] ; # 0..1 Subjective severity of condition
  fhir:bodySite [ CodeableConcept ] ; # 0..1 Anatomical location, if relevant
  fhir:stage [ CodeableConcept ] ; # 0..1 Stage/grade, usually assessed formally
  fhir:hasSeverity [ boolean ] ; # 0..1 Whether Severity is appropriate
  fhir:hasBodySite [ boolean ] ; # 0..1 Whether bodySite is appropriate
  fhir:hasStage [ boolean ] ; # 0..1 Whether stage is appropriate
  fhir:definition  ( [ uri ] ... ) ; # 0..* Formal Definition for the condition
  fhir:observation ( [ # 0..* Observations particularly relevant to this condition
    fhir:category [ CodeableConcept ] ; # 0..1 Category that is relevant
    fhir:code [ CodeableConcept ] ; # 0..1 Code for relevant Observation
  ] ... ) ;
  fhir:medication ( [ # 0..* Medications particularly relevant for this condition
    fhir:category [ CodeableConcept ] ; # 0..1 Category that is relevant
    fhir:code [ CodeableConcept ] ; # 0..1 Code for relevant Medication
  ] ... ) ;
  fhir:precondition ( [ # 0..* Observation that suggets this condition
    fhir:type [ code ] ; # 1..1 sensitive | specific
    fhir:code [ CodeableConcept ] ; # 1..1 Code for relevant Observation
    # value[x] : 0..1 Value of Observation. One of these 2
      fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
      fhir:value [  a fhir:Quantity ; Quantity ]
  ] ... ) ;
  fhir:team  ( [ Reference(CareTeam) ] ... ) ; # 0..* Appropriate team for this condition
  fhir:questionnaire ( [ # 0..* Questionnaire for this condition
    fhir:purpose [ code ] ; # 1..1 preadmit | diff-diagnosis | outcome
    fhir:reference [ Reference(Questionnaire) ] ; # 1..1 Specific Questionnaire
  ] ... ) ;
  fhir:plan ( [ # 0..* Plan that is appropriate
    fhir:role [ CodeableConcept ] ; # 0..1 Use for the plan
    fhir:reference [ Reference(PlanDefinition) ] ; # 1..1 The actual plan
  ] ... ) ;
]

Changes from both R4 and R4B

This resource did not exist in Release R4

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

Structure

Name	Flags	Card.	Type	Description & Constraints
ConditionDefinition	TU		DomainResource	A definition of a condition + Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension Interfaces Implemented: MetadataResource
url	Σ C	0..1	uri	Canonical identifier for this condition definition, represented as a URI (globally unique) + Warning: URL should not contain \| or # - these characters make processing canonical references problematic
identifier	Σ	0..*	Identifier	Additional identifier for the condition definition
version	Σ	0..1	string	Business version of the condition definition
versionAlgorithm[x]	Σ	0..1		How to compare versions Binding: Version Algorithm (Extensible)
versionAlgorithmString			string
versionAlgorithmCoding			Coding
name	Σ C	0..1	string	Name for this condition definition (computer friendly)
title	Σ T	0..1	string	Name for this condition definition (human friendly)
subtitle		0..1	string	Subordinate title of the event definition
status	?!Σ	1..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (Required)
experimental	Σ	0..1	boolean	For testing purposes, not real usage
date	Σ	0..1	dateTime	Date last changed
publisher	Σ T	0..1	string	Name of the publisher/steward (organization or individual)
contact	Σ	0..*	ContactDetail	Contact details for the publisher
description	T	0..1	markdown	Natural language description of the condition definition
useContext	Σ	0..*	UsageContext	The context that the content is intended to support
jurisdiction	Σ XD	0..*	CodeableConcept	Intended jurisdiction for condition definition (if applicable) Binding: Jurisdiction ValueSet (Extensible)
code	Σ	1..1	CodeableConcept	Identification of the condition, problem or diagnosis Binding: Condition/Problem/Diagnosis Codes (Example)
severity	Σ	0..1	CodeableConcept	Subjective severity of condition Binding: Condition/Diagnosis Severity (Preferred)
bodySite	Σ	0..1	CodeableConcept	Anatomical location, if relevant Binding: SNOMED CT Body Structures (Example)
stage	Σ	0..1	CodeableConcept	Stage/grade, usually assessed formally Binding: Condition Stage (Example)
hasSeverity		0..1	boolean	Whether Severity is appropriate
hasBodySite		0..1	boolean	Whether bodySite is appropriate
hasStage		0..1	boolean	Whether stage is appropriate
definition		0..*	uri	Formal Definition for the condition
observation		0..*	BackboneElement	Observations particularly relevant to this condition
category		0..1	CodeableConcept	Category that is relevant Binding: Observation Category Codes (Preferred)
code		0..1	CodeableConcept	Code for relevant Observation Binding: LOINC Codes (Example)
medication		0..*	BackboneElement	Medications particularly relevant for this condition
category		0..1	CodeableConcept	Category that is relevant Binding: Medication request category codes (Example)
code		0..1	CodeableConcept	Code for relevant Medication Binding: SNOMED CT Medication Codes (Example)
precondition		0..*	BackboneElement	Observation that suggets this condition
type		1..1	code	sensitive \| specific Binding: Condition Precondition Type (Required)
code		1..1	CodeableConcept	Code for relevant Observation Binding: LOINC Codes (Example)
value[x]		0..1		Value of Observation
valueCodeableConcept			CodeableConcept
valueQuantity			Quantity
team		0..*	Reference(CareTeam)	Appropriate team for this condition
questionnaire		0..*	BackboneElement	Questionnaire for this condition
purpose		1..1	code	preadmit \| diff-diagnosis \| outcome Binding: Condition Questionnaire Purpose (Required)
reference		1..1	Reference(Questionnaire)	Specific Questionnaire
plan		0..*	BackboneElement	Plan that is appropriate
role		0..1	CodeableConcept	Use for the plan
reference		1..1	Reference(PlanDefinition)	The actual plan
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<ConditionDefinition xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this condition definition, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Additional identifier for the condition definition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the condition definition -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this condition definition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this condition definition (human friendly) -->
 <subtitle value="[string]"/><!-- 0..1 Subordinate title of the event definition -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the condition definition -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for condition definition (if applicable) --></jurisdiction>
 <code><!-- 1..1 CodeableConcept Identification of the condition, problem or diagnosis --></code>
 <severity><!-- 0..1 CodeableConcept Subjective severity of condition --></severity>
 <bodySite><!-- 0..1 CodeableConcept Anatomical location, if relevant --></bodySite>
 <stage><!-- 0..1 CodeableConcept Stage/grade, usually assessed formally --></stage>
 <hasSeverity value="[boolean]"/><!-- 0..1 Whether Severity is appropriate -->
 <hasBodySite value="[boolean]"/><!-- 0..1 Whether bodySite is appropriate -->
 <hasStage value="[boolean]"/><!-- 0..1 Whether stage is appropriate -->
 <definition value="[uri]"/><!-- 0..* Formal Definition for the condition -->
 <observation>  <!-- 0..* Observations particularly relevant to this condition -->
  <category><!-- 0..1 CodeableConcept Category that is relevant --></category>
  <code><!-- 0..1 CodeableConcept Code for relevant Observation --></code>
 </observation>
 <medication>  <!-- 0..* Medications particularly relevant for this condition -->
  <category><!-- 0..1 CodeableConcept Category that is relevant  --></category>
  <code><!-- 0..1 CodeableConcept Code for relevant Medication --></code>
 </medication>
 <precondition>  <!-- 0..* Observation that suggets this condition -->
  <type value="[code]"/><!-- 1..1 sensitive | specific -->
  <code><!-- 1..1 CodeableConcept Code for relevant Observation --></code>
  <value[x]><!-- 0..1 CodeableConcept|Quantity Value of Observation --></value[x]>
 </precondition>
 <team><!-- 0..* Reference(CareTeam) Appropriate team for this condition --></team>
 <questionnaire>  <!-- 0..* Questionnaire for this condition -->
  <purpose value="[code]"/><!-- 1..1 preadmit | diff-diagnosis | outcome -->
  <reference><!-- 1..1 Reference(Questionnaire) Specific Questionnaire --></reference>
 </questionnaire>
 <plan>  <!-- 0..* Plan that is appropriate -->
  <role><!-- 0..1 CodeableConcept Use for the plan --></role>
  <reference><!-- 1..1 Reference(PlanDefinition) The actual plan --></reference>
 </plan>
</ConditionDefinition>

JSON Template

{
  "resourceType" : "ConditionDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this condition definition, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the condition definition
  "version" : "<string>", // Business version of the condition definition
  // versionAlgorithm[x]: How to compare versions. One of these 2:
  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this condition definition (computer friendly)
  "title" : "<string>", // Name for this condition definition (human friendly)
  "subtitle" : "<string>", // Subordinate title of the event definition
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the condition definition
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for condition definition (if applicable)
  "code" : { CodeableConcept }, // R!  Identification of the condition, problem or diagnosis
  "severity" : { CodeableConcept }, // Subjective severity of condition
  "bodySite" : { CodeableConcept }, // Anatomical location, if relevant
  "stage" : { CodeableConcept }, // Stage/grade, usually assessed formally
  "hasSeverity" : <boolean>, // Whether Severity is appropriate
  "hasBodySite" : <boolean>, // Whether bodySite is appropriate
  "hasStage" : <boolean>, // Whether stage is appropriate
  "definition" : ["<uri>"], // Formal Definition for the condition
  "observation" : [{ // Observations particularly relevant to this condition
    "category" : { CodeableConcept }, // Category that is relevant
    "code" : { CodeableConcept } // Code for relevant Observation
  }],
  "medication" : [{ // Medications particularly relevant for this condition
    "category" : { CodeableConcept }, // Category that is relevant 
    "code" : { CodeableConcept } // Code for relevant Medication
  }],
  "precondition" : [{ // Observation that suggets this condition
    "type" : "<code>", // R!  sensitive | specific
    "code" : { CodeableConcept }, // R!  Code for relevant Observation
    // value[x]: Value of Observation. One of these 2:
    "valueCodeableConcept" : { CodeableConcept },
    "valueQuantity" : { Quantity }
  }],
  "team" : [{ Reference(CareTeam) }], // Appropriate team for this condition
  "questionnaire" : [{ // Questionnaire for this condition
    "purpose" : "<code>", // R!  preadmit | diff-diagnosis | outcome
    "reference" : { Reference(Questionnaire) } // R!  Specific Questionnaire
  }],
  "plan" : [{ // Plan that is appropriate
    "role" : { CodeableConcept }, // Use for the plan
    "reference" : { Reference(PlanDefinition) } // R!  The actual plan
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:ConditionDefinition;
  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:url [ uri ] ; # 0..1 Canonical identifier for this condition definition, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the condition definition
  fhir:version [ string ] ; # 0..1 Business version of the condition definition
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this condition definition (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this condition definition (human friendly)
  fhir:subtitle [ string ] ; # 0..1 Subordinate title of the event definition
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the condition definition
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for condition definition (if applicable)
  fhir:code [ CodeableConcept ] ; # 1..1 Identification of the condition, problem or diagnosis
  fhir:severity [ CodeableConcept ] ; # 0..1 Subjective severity of condition
  fhir:bodySite [ CodeableConcept ] ; # 0..1 Anatomical location, if relevant
  fhir:stage [ CodeableConcept ] ; # 0..1 Stage/grade, usually assessed formally
  fhir:hasSeverity [ boolean ] ; # 0..1 Whether Severity is appropriate
  fhir:hasBodySite [ boolean ] ; # 0..1 Whether bodySite is appropriate
  fhir:hasStage [ boolean ] ; # 0..1 Whether stage is appropriate
  fhir:definition  ( [ uri ] ... ) ; # 0..* Formal Definition for the condition
  fhir:observation ( [ # 0..* Observations particularly relevant to this condition
    fhir:category [ CodeableConcept ] ; # 0..1 Category that is relevant
    fhir:code [ CodeableConcept ] ; # 0..1 Code for relevant Observation
  ] ... ) ;
  fhir:medication ( [ # 0..* Medications particularly relevant for this condition
    fhir:category [ CodeableConcept ] ; # 0..1 Category that is relevant
    fhir:code [ CodeableConcept ] ; # 0..1 Code for relevant Medication
  ] ... ) ;
  fhir:precondition ( [ # 0..* Observation that suggets this condition
    fhir:type [ code ] ; # 1..1 sensitive | specific
    fhir:code [ CodeableConcept ] ; # 1..1 Code for relevant Observation
    # value[x] : 0..1 Value of Observation. One of these 2
      fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
      fhir:value [  a fhir:Quantity ; Quantity ]
  ] ... ) ;
  fhir:team  ( [ Reference(CareTeam) ] ... ) ; # 0..* Appropriate team for this condition
  fhir:questionnaire ( [ # 0..* Questionnaire for this condition
    fhir:purpose [ code ] ; # 1..1 preadmit | diff-diagnosis | outcome
    fhir:reference [ Reference(Questionnaire) ] ; # 1..1 Specific Questionnaire
  ] ... ) ;
  fhir:plan ( [ # 0..* Plan that is appropriate
    fhir:role [ CodeableConcept ] ; # 0..1 Use for the plan
    fhir:reference [ Reference(PlanDefinition) ] ; # 1..1 The actual plan
  ] ... ) ;
]

Changes from both R4 and R4B

This resource did not exist in Release R4

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) , the spreadsheet version & the dependency analysis

14.9.5.1 Terminology Bindings

Path	ValueSet	Type	Documentation
ConditionDefinition.versionAlgorithm[x]	VersionAlgorithm	Extensible	Indicates the mechanism used to compare versions to determine which is more current.
ConditionDefinition.status	PublicationStatus	Required	The lifecycle status of an artifact.
ConditionDefinition.jurisdiction	JurisdictionValueSet	Extensible	This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used. Note: The codes for countries and country subdivisions are taken from ISO 3166 while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) .
ConditionDefinition.code	ConditionProblemDiagnosisCodes	Example	Example value set for Condition/Problem/Diagnosis codes.
ConditionDefinition.severity	ConditionDiagnosisSeverity	Preferred	Preferred value set for Condition/Diagnosis severity grading.
ConditionDefinition.bodySite	SNOMEDCTBodyStructures	Example	This value set includes all codes from SNOMED CT where concept is-a 442083009 (Anatomical or acquired body site (body structure)).
ConditionDefinition.stage	ConditionStage	Example	Value set for stages of cancer and other conditions.
ConditionDefinition.observation.category	ObservationCategoryCodes	Preferred	Observation Category codes.
ConditionDefinition.observation.code	LOINCCodes (a valid code from LOINC )	Example	This value set includes all LOINC codes
ConditionDefinition.medication.category	MedicationRequestCategoryCodes	Example	MedicationRequest Category Codes
ConditionDefinition.medication.code	SNOMEDCTMedicationCodes	Example	This value set includes all drug or medicament substance codes and all pharmaceutical/biologic products from SNOMED CT - provided as an exemplar value set.
ConditionDefinition.precondition.type	ConditionPreconditionType	Required	Kind of precondition for the condition.
ConditionDefinition.precondition.code	LOINCCodes (a valid code from LOINC )	Example	This value set includes all LOINC codes
ConditionDefinition.questionnaire.purpose	ConditionQuestionnairePurpose	Required	The use of a questionnaire.

Path

ValueSet

Type

Documentation

ConditionDefinition.versionAlgorithm[x]

VersionAlgorithm

Extensible

Indicates the mechanism used to compare versions to determine which is more current.

ConditionDefinition.status

PublicationStatus

Required

The lifecycle status of an artifact.

ConditionDefinition.jurisdiction

JurisdictionValueSet

Extensible

This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used.

Note: The codes for countries and country subdivisions are taken from ISO 3166 icon while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) icon .

ConditionDefinition.code

ConditionProblemDiagnosisCodes

Example

Example value set for Condition/Problem/Diagnosis codes.

ConditionDefinition.severity

ConditionDiagnosisSeverity

Preferred

Preferred value set for Condition/Diagnosis severity grading.

ConditionDefinition.bodySite

SNOMEDCTBodyStructures

Example

This value set includes all codes from SNOMED CT icon where concept is-a 442083009 (Anatomical or acquired body site (body structure)).

ConditionDefinition.stage

ConditionStage

Example

Value set for stages of cancer and other conditions.

ConditionDefinition.observation.category

ObservationCategoryCodes

Preferred

Observation Category codes.

ConditionDefinition.observation.code

LOINCCodes (a valid code from LOINC icon

)

Example

This value set includes all LOINC codes

ConditionDefinition.medication.category

MedicationRequestCategoryCodes icon

Example

MedicationRequest Category Codes

ConditionDefinition.medication.code

SNOMEDCTMedicationCodes

Example

This value set includes all drug or medicament substance codes and all pharmaceutical/biologic products from SNOMED CT - provided as an exemplar value set.

ConditionDefinition.precondition.type

ConditionPreconditionType

Required

Kind of precondition for the condition.

ConditionDefinition.precondition.code

LOINCCodes (a valid code from LOINC icon

)

Example

This value set includes all LOINC codes

ConditionDefinition.questionnaire.purpose

ConditionQuestionnairePurpose

Required

The use of a questionnaire.

14.9.5.2 Constraints

UniqueKey

Level

Location

Description

Expression

cnl-0

Warning

(base)

Name should be usable as an identifier for the module by machine processing applications such as code generation

name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')

cnl-1

Warning

ConditionDefinition.url

URL should not contain | or # - these characters make processing canonical references problematic

exists() implies matches('^[^|# ]+$')

14.9.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to 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
context	token	A use context assigned to the condition definition	(ConditionDefinition.useContext.value.ofType(CodeableConcept))	30 Resources
context-quantity	quantity	A quantity- or range-valued use context assigned to the condition definition	(ConditionDefinition.useContext.value.ofType(Quantity)) \| (ConditionDefinition.useContext.value.ofType(Range))	30 Resources
context-type	token	A type of use context assigned to the condition definition	ConditionDefinition.useContext.code	30 Resources
context-type-quantity	composite	A use context type and quantity- or range-based value assigned to the condition definition	On ConditionDefinition.useContext: context-type: code context-quantity: value.ofType(Quantity) \| value.ofType(Range)	30 Resources
context-type-value	composite	A use context type and value assigned to the condition definition	On ConditionDefinition.useContext: context-type: code context: value.ofType(CodeableConcept)	30 Resources
date	date	The condition definition publication date	ConditionDefinition.date	30 Resources
description	string	The description of the condition definition	ConditionDefinition.description	28 Resources
identifier	token	External identifier for the condition definition	ConditionDefinition.identifier	34 Resources
jurisdiction	token	Intended jurisdiction for the condition definition	ConditionDefinition.jurisdiction	26 Resources
name	string	Computationally friendly name of the condition definition	ConditionDefinition.name	26 Resources
publisher	string	Name of the publisher of the condition definition	ConditionDefinition.publisher	30 Resources
status	token	The current status of the condition definition	ConditionDefinition.status	35 Resources
title	string	The human-friendly name of the condition definition	ConditionDefinition.title	27 Resources
url	uri	The uri that identifies the condition definition	ConditionDefinition.url	34 Resources
version	token	The business version of the condition definition	ConditionDefinition.version	30 Resources