Practice Location

Last updated: 24 Sep 2025

Introduction #

The PracticeLocation model lists all the clinical practice locations that fall under an Organization.

Basic usage #

To query a PracticeLocation by name, the filter method can be used like so:

from canvas_sdk.v1.data.practicelocation import PracticeLocation

practice_location = PracticeLocation.objects.filter(full_name__icontains="downtown")

To retrieve a list of all practice locations:

from canvas_sdk.v1.data.practicelocation import PracticeLocation

practice_locations = PracticeLocation.objects.all()

Each PracticeLocation has location-specific settings that control certain behavior within the EMR application. To retrieve the available settings for a PracticeLocation instance, the settings attribute can be used to retrieve a list of names:

from canvas_sdk.v1.data.practicelocation import PracticeLocation

practice_location = PracticeLocation.objects.first()

available_settings = practice_location.settings.values_list('name', flat=True)

Additionally, a setting’s value can be found by accessing the value attribute on the PracticeLocationSetting:

from canvas_sdk.v1.data.practicelocation import PracticeLocation

practice_location = PracticeLocation.objects.first()

preferred_lab_partner_text = practice_location.settings.get(name="preferredLabPartner").value

Please note that the content of each value field can contain any value that is JSON-serializable, which includes string values. This means that value could be any of the Python types string, list or dict.

Attributes #