PractitionerRole

A practitioner's roles, specialties, and locations within an organization.

Connects Practitioner, Organization, and Location: which clinician works where, in what capacity. Useful for building provider directories or resolving who can be booked at which site.

Advertises a validated CA Core+ profile.

Access

Mode	Interactions	Scopes
App launch	read + search	`user/PractitionerRole.rs`
Backend services	read + search	`system/PractitionerRole.rs`

Search parameters

Search results are searchset Bundles; follow the Bundle's next link for cursor pagination.

Parameter	Type	Description
`_id`	token	Match a specific logical resource id.
`_lastUpdated`	date	Filter by last modification time; supports FHIR date prefixes such as ge and lt.
`_count`	number	Page size hint for the searchset Bundle.
`_page_token`	string	Opaque pagination cursor. Never construct one — follow the Bundle's next link.
`practitioner`	reference	Roles held by a specific Practitioner.
`organization`	reference	Roles within a specific Organization.
`location`	reference	Roles delivered at a specific Location.
`active`	token	Whether the role is in active use (true/false).

Find a practitioner's roles

Request

curl "https://sandbox.avaemr.ca/fhir/r4/{partition_id}/PractitionerRole?practitioner=Practitioner/synthetic-practitioner-1" \
  -H "Authorization: Bearer $SMART_ACCESS_TOKEN" \
  -H "Accept: application/fhir+json"

Response · launch context

{
  "resourceType": "Bundle",
  "type": "searchset",
  "link": [
    { "relation": "self", "url": "https://sandbox.avaemr.ca/fhir/r4/{partition_id}/PractitionerRole?practitioner=Practitioner/synthetic-practitioner-1" }
  ],
  "entry": [
    {
      "resource": {
        "resourceType": "PractitionerRole",
        "id": "synthetic-practitioner-role-1",
        "active": true,
        "practitioner": { "reference": "Practitioner/synthetic-practitioner-1" },
        "organization": { "reference": "Organization/synthetic-organization-1" },
        "location": [{ "reference": "Location/synthetic-location-1" }],
        "code": [{ "text": "Family physician" }]
      },
      "search": { "mode": "match" }
    }
  ]
}