Medication History

Last updated: 2 Oct 2025

Introduction #

The MedicationHistoryMedication model represents historical medication data for a patient, typically imported from external sources such as health information exchanges or pharmacy systems. The MedicationHistoryResponse model tracks responses to medication history requests.

Basic usage #

To get a medication history record by identifier, use the get method on the MedicationHistoryMedication model manager:

from canvas_sdk.v1.data.medication_history import MedicationHistoryMedication

medication_history = MedicationHistoryMedication.objects.get(id="b80b1cdc-2e6a-4aca-90cc-ebc02e683f35")

If you have a patient object, the medication history for a patient can be accessed with the medication_history_medications attribute on a Patient object:

from canvas_sdk.v1.data.patient import Patient

patient = Patient.objects.get(id="1eed3ea2a8d546a1b681a2a45de1d790")
medication_history = patient.medication_history_medications.all()

Codings #

The codings for a medication history record can be accessed with the codings attribute on a MedicationHistoryMedication object:

from canvas_sdk.v1.data.medication_history import MedicationHistoryMedication
from logger import log

medication_history = MedicationHistoryMedication.objects.get(id="b80b1cdc-2e6a-4aca-90cc-ebc02e683f35")

for coding in medication_history.codings.all():
    log.info(f"system:  {coding.system}")
    log.info(f"code:    {coding.code}")
    log.info(f"display: {coding.display}")

Filtering #

Medication history records can be filtered by any attribute that exists on the model.

Filtering is done with the filter method on the MedicationHistoryMedication model manager.

By attribute #

Specify an attribute with filter to filter by that attribute:

from canvas_sdk.v1.data.medication_history import MedicationHistoryMedication

medications = MedicationHistoryMedication.objects.filter(dea_schedule="CII")

By date range #

Filter by last fill date or written date:

from canvas_sdk.v1.data.medication_history import MedicationHistoryMedication
from datetime import datetime

medications = MedicationHistoryMedication.objects.filter(
    last_fill_date__gte=datetime(2023, 1, 1)
)

Attributes #