# Medication

Canonical page: https://docs.ovok.com/api/fhir/r4/medication

This resource is primarily used for the identification and definition of a medication for the purposes of prescribing, dispensing, and administering a medication as well as for making statements about medication use.

These interaction paths describe standard FHIR R4 patterns. Availability can depend on the API capabilities enabled for your Ovok project.

| **Interaction** | **Method** | **Path** |
| --- | --- | --- |
| Read | `GET` | `/fhir/R4/Medication/[id]` |
| Vread | `GET` | `/fhir/R4/Medication/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/Medication/[id]` |
| Patch | `PATCH` | `/fhir/R4/Medication/[id]` |
| Delete | `DELETE` | `/fhir/R4/Medication/[id]` |
| Create | `POST` | `/fhir/R4/Medication` |
| Search | `GET` | `/fhir/R4/Medication` |
| History | `GET` | `/fhir/R4/Medication/[id]/_history` |

## Top-level elements [#top-level-elements]

| **Element** | **Type** | **Cardinality** | **Description** |
| --- | --- | --- | --- |
| <span id="element-id"></span>`id` | [string](/fhir-elements/primitive/string) | `0..1` | Logical id of this artifact |
| <span id="element-meta"></span>`meta` | [Meta](/fhir-elements/complex/meta) | `0..1` | Metadata about the resource |
| <span id="element-implicit-rules"></span>`implicitRules` | [uri](/fhir-elements/primitive/uri) | `0..1` | A set of rules under which this content was created |
| <span id="element-language"></span>`language` | [code](/fhir-elements/primitive/code) | `0..1` | Language of the resource content |
| <span id="element-text"></span>`text` | [Narrative](/fhir-elements/complex/narrative) | `0..1` | Text summary of the resource, for human interpretation |
| <span id="element-contained"></span>`contained` | [Resource](/fhir-elements/foundation/resource) | `0..*` | Contained, inline Resources |
| <span id="element-extension"></span>`extension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Additional content defined by implementations |
| <span id="element-modifier-extension"></span>`modifierExtension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Extensions that cannot be ignored |
| <span id="element-identifier"></span>`identifier` | [Identifier](/fhir-elements/complex/identifier) | `0..*` | Business identifier for this medication |
| <span id="element-code"></span>`code` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Codes that identify this medication |
| <span id="element-status"></span>`status` | [code](/fhir-elements/primitive/code) | `0..1` | active \| inactive \| entered-in-error |
| <span id="element-manufacturer"></span>`manufacturer` | [Reference](/fhir-elements/complex/reference) | `0..1` | Manufacturer of the item |
| <span id="element-form"></span>`form` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | powder \| tablets \| capsule + |
| <span id="element-amount"></span>`amount` | [Ratio](/fhir-elements/complex/ratio) | `0..1` | Amount of drug in package |
| <span id="element-ingredient"></span>`ingredient` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..*` | Active or inactive ingredient |
| <span id="element-batch"></span>`batch` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..1` | Details about packaged medications |

## Resource-specific search parameters [#resource-specific-search-parameters]

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| `code` | token | Multiple Resources: AllergyIntolerance: Code that identifies the allergy or intolerance ; Condition: Code for the condition ; DeviceRequest: Code for what is being requested/ordered ; DiagnosticReport: The code for the report, as opposed to codes for the atomic results, which are the names on the observation resource referred to from the result ; FamilyMemberHistory: A search by a condition code ; List: What the purpose of this list is ; Medication: Returns medications for a specific code ; MedicationAdministration: Return administrations of this medication code ; MedicationDispense: Returns dispenses of this medicine code ; MedicationRequest: Return prescriptions of this medication code ; MedicationStatement: Return statements of this medication code ; Observation: The code of the observation type ; Procedure: A code to identify a  procedure ; ServiceRequest: What is being requested/ordered  |
| `expiration-date` | date | Returns medications in a batch with this expiration date |
| `form` | token | Returns medications for a specific dose form |
| `identifier` | token | Returns medications with this external identifier |
| `ingredient` | reference | Returns medications for this ingredient reference |
| `ingredient-code` | token | Returns medications for this ingredient code |
| `lot-number` | token | Returns medications in a batch with this lot number |
| `manufacturer` | reference | Returns medications made or sold for this manufacturer |
| `status` | token | Returns medications for this status |

## Reference [#reference]

Official FHIR R4 spec: [Medication](https://hl7.org/fhir/R4/medication.html).  
Maturity: Trial Use 3 (FMM 3).
