---
title: 'PractitionerRole (FHIR R5)'
description: 'FHIR R5 PractitionerRole resource.'
nav: 'API / R5 / PractitionerRole'
order: 120
version: v1
fhir: r5
source: generated
updated: '2026-09-23'
---

# PractitionerRole (FHIR R5)

<FhirResourceHeader fhir="r5" slug="practitionerrole" />

FHIR R5 PractitionerRole resource.

> This page is auto-generated from the server's FHIR R5 CapabilityStatement (`/fhir/R5/metadata`).

## FHIR R5 Specification

Official spec: [PractitionerRole — HL7 FHIR R5](https://hl7.org/fhir/R5/practitionerrole.html)

## Supported Interactions

- **read** — Read a single resource by ID (`GET /fhir/R5/{Resource}/{id}`)
- **search-type** — Search resources with query parameters (`GET /fhir/R5/{Resource}?...`)

<Callout variant="note">
Authorized by the SMART scope `system/Practitioner.rs`. This resource inherits an existing scope — no per-resource `system/PractitionerRole.*` scope is minted; requesting one is rejected.
</Callout>

## Scopes

Scopes are shared across FHIR releases — the same `system/PractitionerRole.*` scope grants PractitionerRole access on both `/fhir/R4` and `/fhir/R5`.

- <Scope name="system/Practitioner.rs" /> — see [scope reference](/v1/scopes#system-practitioner-rs)

## Search Parameters

| Parameter | Type | Notes |
|-----------|------|-------|
| `_id` | token | Exact match. For identifiers use `system|value` format. |
| `practitioner` | reference | Resource reference — supply the UUID of the referenced resource. |
| `location` | reference | Resource reference — supply the UUID of the referenced resource. |
| `_count` | number | Integer. For `_count`: default 20, max 100. |
| `_offset` | number | Integer. For `_count`: default 20, max 100. |

## Endpoints

Operations, request/response examples, and code samples mirror the R4 surface — call them at `/fhir/R5` with the same token and scopes. See the [PractitionerRole R4 reference](/v1/api/r4/practitionerrole).