> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# medicationstatement

A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. See the [HL7 FHIR R4 spec](https://hl7.org/fhir/R4/medicationstatement.html) for full details.

**Previous version:** [medication\_statement](/medical-api/handling-data/schema-v000/medication-statement)

**Tables in this resource:**

* **medicationstatement** – Main medication statement record (this page)
* [medicationstatement\_dosage](/medical-api/handling-data/schema-v100/medicationstatement/dosage) – Dosage instructions per statement
* [medicationstatement\_dosage\_doseandrate](/medical-api/handling-data/schema-v100/medicationstatement/dosage_doseandrate) – Dose/rate quantities per dosage
* [medicationstatement\_dosage\_route\_coding](/medical-api/handling-data/schema-v100/medicationstatement/dosage_route_coding)
* [medicationstatement\_extension](/medical-api/handling-data/schema-v100/medicationstatement/extension)
* [medicationstatement\_extension\_vcc\_coding](/medical-api/handling-data/schema-v100/medicationstatement/extension_vcc_coding)
* **medicationstatement\_references** – Normalized references; see [Reference Tables](/medical-api/handling-data/schema-v100/reference_tables)

**Reference Table:**

The `medicationstatement_references` table contains normalized references from the medication statement to other entities. It supports the following reference properties:

* **medication\_reference** (required): links to the medication being taken
* **subject** (required): links to the patient who is taking the medication

For detailed information about reference table structure and indexing, see the [Reference Tables documentation](/medical-api/handling-data/schema-v100/reference_tables).

**Primary Keys:**

* medicationstatement\_id

**Foreign Keys:**

* patient\_id – links to the [patient](/medical-api/handling-data/schema-v100/patient/base) table
* medication\_id – links to the [medication](/medical-api/handling-data/schema-v100/medication/base) table

<div style={{textAlign: 'right'}}><sub>† Metriport Platform added</sub></div>

| Column                                   | Data Type | Description                                                                                                        |
| ---------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------ |
| medicationstatement\_id                  | varchar   | Unique identifier for the medication statement                                                                     |
| patient\_id                              | varchar   | Unique identifier for the patient (subject)                                                                        |
| medication\_id                           | varchar   | Reference to the medication                                                                                        |
| status                                   | varchar   | Status of the statement (e.g. active, completed, entered-in-error, intended, stopped, on-hold, unknown, not-taken) |
| effectivedatetime                        | datetime  | Effective date/time if provided directly                                                                           |
| effectiveperiod\_start                   | datetime  | Start of effective period                                                                                          |
| effective\_date†                         | datetime  | Coalesced effective date (effectivedatetime or effectiveperiod\_start)                                             |
| effectiveperiod\_end                     | datetime  | End of effective period                                                                                            |
| dosage\_doseandrate\_dosequantity\_unit  | varchar   | Unit for the dose quantity                                                                                         |
| dosage\_doseandrate\_dosequantity\_value | varchar   | Dose quantity value                                                                                                |
| note\_text†                              | varchar   | Additional notes about the statement (first note)                                                                  |
| meta\_source                             | varchar   | Source document filename from FHIR meta.source                                                                     |
| data\_source\_ext†                       | varchar   | Integration source derived from FHIR extension                                                                     |

**Related Tables:**

**Parent:**

* [medication](/medical-api/handling-data/schema-v100/medication/base)
* [patient](/medical-api/handling-data/schema-v100/patient/base)

**Child:**

* [medicationstatement\_dosage](/medical-api/handling-data/schema-v100/medicationstatement/dosage)
* [medicationstatement\_extension](/medical-api/handling-data/schema-v100/medicationstatement/extension)

## Version diff

**Renamed**

* `medication_statement_id` → `medicationstatement_id`
* `data_source` → `meta_source`