> ## 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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.