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

# PractitionerRole

> A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.

## Properties

| Name                   | Required | Type                                                                              | Description                                                                                        |
| ---------------------- | -------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| identifier             | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                          | Business Identifiers that are specific to a role/location                                          |
| active                 | No       | boolean                                                                           | Whether this practitioner role record is in active use                                             |
| period                 | No       | [Period](/medical-api/fhir/data-types/period)                                     | The period during which the practitioner is authorized to perform in these role(s)                 |
| practitioner           | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner)>              | Practitioner that is able to provide the defined services for the organization                     |
| organization           | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>              | Organization where the roles are available                                                         |
| code                   | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                | Roles which this practitioner may perform                                                          |
| specialty              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                | Specific specialty of the practitioner                                                             |
| location               | No       | Reference\<[Location](/medical-api/fhir/resources/location)>\[]                   | The location(s) at which this practitioner provides care                                           |
| healthcareService      | No       | Reference\<[HealthcareService](/medical-api/fhir/resources/healthcareservice)>\[] | The list of healthcare services that this worker provides for this role's Organization/Location(s) |
| telecom                | No       | [ContactPoint](/medical-api/fhir/data-types/contactpoint)\[]                      | Contact details that are specific to the role/location/service                                     |
| availableTime          | No       | PractitionerRoleAvailableTime                                                     | Times the Service Site is available                                                                |
| - id                   | No       | string                                                                            | Unique id for inter-element referencing                                                            |
| - extension            | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                            | Additional content defined by implementations                                                      |
| - modifierExtension    | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                            | Extensions that cannot be ignored even if unrecognized                                             |
| - daysOfWeek           | No       | code\[]                                                                           | mon / tue / wed / thu / fri / sat / sun                                                            |
| - allDay               | No       | boolean                                                                           | Always available? e.g. 24 hour service                                                             |
| - availableStartTime   | No       | time                                                                              | Opening time of day (ignored if allDay = true)                                                     |
| - availableEndTime     | No       | time                                                                              | Closing time of day (ignored if allDay = true)                                                     |
| notAvailable           | No       | PractitionerRoleNotAvailable                                                      | Not available during this time due to provided reason                                              |
| - id                   | No       | string                                                                            | Unique id for inter-element referencing                                                            |
| - extension            | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                            | Additional content defined by implementations                                                      |
| - modifierExtension    | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                            | Extensions that cannot be ignored even if unrecognized                                             |
| - description          | Yes      | string                                                                            | Reason presented to the user explaining why time not available                                     |
| - during               | No       | [Period](/medical-api/fhir/data-types/period)                                     | Service not available from this date                                                               |
| availabilityExceptions | No       | string                                                                            | Description of availability exceptions                                                             |
| endpoint               | No       | Reference\<[Endpoint](/medical-api/fhir/resources/endpoint)>\[]                   | Technical endpoints providing access to services operated for the practitioner with this role      |

## Search Parameters

| Name         | Type      | Description                                                                                        | Expression                         |
| ------------ | --------- | -------------------------------------------------------------------------------------------------- | ---------------------------------- |
| email        | token     | A value in an email contact                                                                        | PractitionerRole.telecom           |
| phone        | token     | A value in a phone contact                                                                         | PractitionerRole.telecom           |
| telecom      | token     | The value in any kind of contact                                                                   | PractitionerRole.telecom           |
| active       | token     | Whether this practitioner role record is in active use                                             | PractitionerRole.active            |
| date         | date      | The period during which the practitioner is authorized to perform in these role(s)                 | PractitionerRole.period            |
| endpoint     | reference | Technical endpoints providing access to services operated for the practitioner with this role      | PractitionerRole.endpoint          |
| identifier   | token     | A practitioner's Identifier                                                                        | PractitionerRole.identifier        |
| location     | reference | One of the locations at which this practitioner provides care                                      | PractitionerRole.location          |
| organization | reference | The identity of the organization the practitioner represents / acts on behalf of                   | PractitionerRole.organization      |
| practitioner | reference | Practitioner that is able to provide the defined services for the organization                     | PractitionerRole.practitioner      |
| role         | token     | The practitioner can perform this role at for the organization                                     | PractitionerRole.code              |
| service      | reference | The list of healthcare services that this worker provides for this role's Organization/Location(s) | PractitionerRole.healthcareService |
| specialty    | token     | The practitioner has this specialty at an organization                                             | PractitionerRole.specialty         |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [PractitionerRole](https://www.hl7.org/fhir/StructureDefinition/PractitionerRole).