> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectivehealth.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PractitionerRole

> The FHIR PractitionerRole resource as produced by Connective Health

[FHIR R4 PractitionerRole](https://www.hl7.org/fhir/R4/practitionerrole.html) ·
[US Core PractitionerRole](https://hl7.org/fhir/us/core/STU9/StructureDefinition-us-core-practitionerrole.html)

<Info>
  `PractitionerRole` is how a provider is referenced in all three FHIR outputs. In
  [Bulk Medication History](/fhir/bulk-medication-history-bundle) it is a standalone resource representing the
  prescriber. In the [Patient Everything](/fhir/patient-everything-bundle) and
  [Patient Summary](/fhir/patient-summary-bundle) 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.
</Info>

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](/fhir/resources/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](/fhir/resources/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](/fhir/resources/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](http://nucc.org/provider-taxonomy) -- see [Code Systems](/fhir/code-systems). Not currently populated in Bulk Med History; no specialty code is available for prescribers in that context.                |

<Note>
  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.
</Note>