Release 4 Value Set

Pharmacy Work Group Maturity Level: 3Trial Use Use Context: Any

This is a value set defined by the FHIR project.


Defining URL:
Name:Medication Status Codes
Title:Medication status codes

Medication Status Codes

Committee:Pharmacy Work Group
OID:2.16.840.1.113883.4.642.3.367 (for OID based terminology systems)
Source ResourceXML / JSON

This value set is used in the following places:

This value set includes codes from the following code systems:


This expansion generated 21 Jan 2021

This value set contains 8 concepts

Expansion based on version 4.0.1

All codes from system

CodeDisplayDefinitionCanonical Status
activeActiveThe medication is still being taken.~active
completedCompletedThe medication is no longer being taken.~complete
entered-in-errorEntered in ErrorSome of the actions that are implied by the medication statement may have occurred. For example, the patient may have taken some of the medication. Clinical decision support systems should take this status into account.~error
intendedIntendedThe medication may be taken at some time in the future.~planned
stoppedStoppedActions implied by the statement have been permanently halted, before all of them occurred. This should not be used if the statement was entered in error.~failed
on-holdOn HoldActions implied by the statement have been temporarily halted, but are expected to continue later. May also be called 'suspended'.~suspended
unknownUnknownThe state of the medication use is not currently known.~unknown
not-takenNot TakenThe medication was not consumed by the patient~not-done


See the full registry of value sets defined as part of FHIR.

Explanation of the columns that may appear on this page:

LvlA few code lists that FHIR defines are hierarchical - each code is assigned a level. For value sets, levels are mostly used to organize codes for user convenience, but may follow code system hierarchy - see Code System for further information
SourceThe source of the definition of the code (when the value set draws in codes defined elsewhere)
CodeThe code (used as the code in the resource instance). If the code is in italics, this indicates that the code is not selectable ('Abstract')
DisplayThe display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
DefinitionAn explanation of the meaning of the concept
CommentsAdditional notes about how to use the code