## On this page

Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient; e.g. Drug-drug interaction, Ineffective treatment frequency, [Procedure](/content/docs/api/fhir/resources/procedure/index.html)-condition conflict, etc.

## Elements

| Name                       | Required | Type                                                                                                       | Description                                                                                                                                                                                                                                                                                                                     |
|----------------------------|----------|------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| identifier                 |          | [Identifier](/content/docs/api/fhir/datatypes/identifier/index.html)[]                               | Unique id for the detected issue<br>Details<br>Business identifier associated with the detected issue record.                                                                                                                                                                                                                     |
| status                     | ✓        | code                                                                                                       | registered \\| preliminary \\| final \\| amended +<br>Details<br>Indicates the status of the detected issue.<br>This element is labeled as a modifier because the status contains the codes cancelled and entered-in-error that mark the issue as not currently valid.                                                                                            |
| code                       |          | [CodeableConcept](/content/docs/api/fhir/datatypes/codeableconcept/index.html)                       | Issue Category, e.g. drug-drug, duplicate therapy, etc.<br>Details<br>Identifies the general type of issue identified.                                                                                                                                                                                                            |
| severity                   |          | code                                                                                                       | high \\| moderate \\| low<br>Details<br>Indicates the degree of importance associated with the identified issue based on the potential impact on the patient.                                                                                                                                                         |
| patient                    |          | Reference<[Patient](/content/docs/api/fhir/resources/patient/index.html)>                             | Associated patient<br>Details<br>Indicates the patient whose record the detected issue is associated with.                                                                                                                                                                                                                     |
| identified[x]             |          | dateTime, [Period](/content/docs/api/fhir/datatypes/period/index.html)                              | When identified<br>Details<br>The date or period when the detected issue was initially identified.                                                                                                                                                                                                                              |
| author                     |          | Reference<[Practitioner](/content/docs/api/fhir/resources/practitioner/index.html)<br>| [PractitionerRole](/content/docs/api/fhir/resources/practitionerrole/index.html)<br>| [Device](/content/docs/api/fhir/resources/device/index.html)> | The provider or device that identified the issue<br>Details<br>Individual or device responsible for the issue being raised. For example, a decision support application or a pharmacist conducting a medication review.                                                                                                          |
| implicated                  |          | Reference<Resource>[]                                                                                      | Problem resource<br>Details<br>Indicates the resource representing the current activity or proposed activity that is potentially problematic.<br>There's an implicit constraint on the number of implicated resources based on DetectedIssue.type; e.g. For drug-drug, there would be more than one. For timing, there would typically only be one.               |
| evidence                   |          | DetectedIssueEvidence[]                                                                                     | Supporting evidence<br>Details<br>Supporting evidence or manifestations that provide the basis for identifying the detected issue such as a GuidanceResponse or MeasureReport.                                                                                                                                              |
| id                         |          | string                                                                                                     | Unique id for inter-element referencing<br>Details<br>Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.                                                                                                                                     |
| extension                  |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                               | Additional content defined by implementations<br>Details<br>May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions.                                                                                                           |
| modifierExtension           |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                               | Extensions that cannot be ignored even if unrecognized<br>Details<br>May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants.                                                        |
| code                       |          | [CodeableConcept](/content/docs/api/fhir/datatypes/codeableconcept/index.html)[]                     | Manifestation<br>Details<br>A manifestation that led to the recording of this detected issue.                                                                                                                                                                                                                                   |
| detail                     |          | Reference<Resource>[]                                                                                      | Supporting information<br>Details<br>Links to resources that constitute evidence for the detected issue such as a GuidanceResponse or MeasureReport.                                                                                                                                                  |
| detail                     |          | string                                                                                                     | Description and context<br>Details<br>A textual explanation of the detected issue.<br>Should focus on information not covered elsewhere as discrete data - no need to duplicate the narrative.                                                                                                                                     |
| reference                  |          | uri                                                                                                        | Authority for issue<br>Details<br>The literature, knowledge-base or similar reference that describes the propensity for the detected issue identified.                                                                                                                                                                                                                   |
| mitigation                 |          | DetectedIssueMitigation[]                                                                                  | Step taken to address<br>Details<br>Indicates an action that has been taken or is committed to reduce or eliminate the likelihood of the risk identified by the detected issue from manifesting. Can also reflect an observation of known mitigating factors that may reduce/eliminate the need for any action.                                 |
| id                         |          | string                                                                                                     | Unique id for inter-element referencing<br>Details<br>Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.                                                                                                                                                              |
| extension                  |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                               | Additional content defined by implementations<br>Details<br>May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions.                                                                                                                  |
| modifierExtension           |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                               | Extensions that cannot be ignored even if unrecognized<br>Details<br>May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants.                                                        |
| action                     | ✓        | [CodeableConcept](/content/docs/api/fhir/datatypes/codeableconcept/index.html)                       | What mitigation?<br>Details<br>Describes the action that was taken or the observation that was made that reduces/eliminates the risk associated with the identified issue.<br>The "text" component can be used for detail or when no appropriate code exists.                                                                  |
| date                       |          | dateTime                                                                                                   | Date committed<br>Details<br>Indicates when the mitigating action was documented.<br>This might not be the same as when the mitigating step was actually taken.                                                                                                                                           |
| author                     |          | Reference<[Practitioner](/content/docs/api/fhir/resources/practitioner/index.html)  
| [PractitionerRole](/content/docs/api/fhir/resources/practitionerrole/index.html)>                             | Who is committing?<br>Details<br>Identifies the practitioner who determined the mitigation and takes responsibility for the mitigation step occurring.                                                                                                           |

## Search Parameters

| Name         | Type     | Description                             | Expression                       |
|--------------|----------|----------------------------------------|----------------------------------|
| identifier   | token    | Unique id for the detected issue       | DetectedIssue.identifier         |
| patient      | reference | Associated patient                     | DetectedIssue.patient            |
| author       | reference | The provider or device that identified the issue | DetectedIssue.author            |
| code         | token    | Issue Category, e.g. drug-drug, duplicate therapy, etc. | DetectedIssue.code              |
| identified   | date     | When identified                        | DetectedIssue.identified        |
| implicated    | reference | Problem resource                       | DetectedIssue.implicated        |
| status       | token    | The status of the detected issue       | DetectedIssue.status            |

## Inherited Elements

| Name              | Required | Type                                                                                       | Description                                                                                                                                                                                                                                                                                           |
|-------------------|----------|--------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| id                 |          | string                                                                                     | Logical id of this artifact<br>Details<br>The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.<br>The only time that a resource does not have an id is when it is being submitted to the server using a create operation.                                          |
| meta               |          | [Meta](/content/docs/api/fhir/datatypes/meta/index.html)                              | Metadata about the resource<br>Details<br>The 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.                                                                            |
| implicitRules      |          | uri                                                                                        | A set of rules under which this content was created<br>Details<br>A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content.                                                                                                                                                                   |
| language           |          | code                                                                                       | Language of the resource content<br>Details<br>The base language in which the resource is written.<br>Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative.                         |
| text               |          | [Narrative](/content/docs/api/fhir/datatypes/narrative/index.html)                    | Text summary of the resource, for human interpretation<br>Details<br>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.                    |
| contained          |          | Resource[]                                                                                  | Contained, inline Resources<br>Details<br>These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.                                                         |
| extension          |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                  | Additional content defined by implementations<br>Details<br>May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions.         |
| modifierExtension   |          | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[]                  | Extensions that cannot be ignored<br>Details<br>May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants.           |
