FHIR R4 PractitionerRole · US Core PractitionerRole

PractitionerRole is how a provider is referenced in all three FHIR outputs. In Bulk Medication History it is a standalone resource representing the prescriber. In the Patient Everything and Patient Summary bundles it is contained inside whichever clinical resource names the provider. The Stable ID and Fields sections below cover both, with a column per output.

In the bundles, every provider reference points at a contained PractitionerRole rather than directly at a Practitioner. It appears as Encounter.participant.individual, Observation.performer, DiagnosticReport.performer, Procedure.performer.actor, MedicationRequest.requester, CarePlan.author, DocumentReference.author, and Condition.recorder. In Bulk Med History, it represents the prescriber’s role and is referenced as the requester on the MedicationRequest.

Stable ID

Output	Recipe
Patient Everything / Summary	No `id` is assigned — the resource is contained inside the clinical resource that references it, and is therefore neither addressable on its own nor deduplicated.
Bulk Med History	Fixed to the pattern `practitionerRole-{medicationUniqueId}`, tied to the specific medication record rather than to the prescriber’s real-world identity — the same caveat described on the Practitioner page applies here as well.

Fields

Field	Patient Everything / Summary	Bulk Med History	Notes
`meta.profile`	1..1	1..1	Always set to the US Core PractitionerRole profile URL.
`practitioner`	0..1	1..1	Reference to a Practitioner. In the bundles this is a contained resource, omitted when the source carries no NPI and no name (for example when only a facility is known); in Bulk Med History it is always the prescriber and always populated.
`location`	0..1	1..1	Reference to a Location for the facility. In the bundles this is contained and omitted when the source carries neither a facility name nor a facility address; in Bulk Med History it is always the prescriber’s office address, built from a different `Location` than the pharmacy `Location` referenced on `MedicationDispense`.
`telecom` (phone)	0..*	0..1	The provider’s work phone number(s). The bundles publish every work phone; Bulk Med History publishes the prescriber’s single work phone number, when present. Home and mobile numbers are not published here in either output.
`telecom` (fax)	0..*	0..1	The provider’s work fax number(s), same distinction as phone above.
`specialty`	0..*	0..0	Bundles only: one entry per specialty code, combining the provider’s primary specialty and any additional specialties. Typically NUCC Provider Taxonomy — see Code Systems. Not currently populated in Bulk Med History; no specialty code is available for prescribers in that context.

In the bundles, a PractitionerRole is only produced when there is either a usable provider or a usable facility, so a clinical resource with neither simply omits its provider reference entirely. organization, code, period, and availableTime are not populated in either output.

Welcome

Product

FHIR

Implementation

APIs

PractitionerRole

Stable ID

Fields

​Stable ID

​Fields

Stable ID

Fields