This page is part of the FHIR Specification (v1.4.0:
STU
3 Ballot 3). The current version which supercedes this version is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
. For a full list of available versions, see the
Directory of published versions
.
Page
versions:
. Page versions:
R5
R4B
R4
R3
R2
|
|
Compartments
|
A person who is directly or indirectly involved in the provisioning of healthcare.
Practitioner covers all individuals who are engaged in the healthcare process and healthcare-related services as part of their formal responsibilities and this Resource is used for attribution of activities and responsibilities to these individuals. Practitioners include (but are not limited to):
The Resource SHALL NOT be used for persons involved without a formal responsibility like individuals taking care for friends, relatives or neighbors. These can be registered as a Patient's Contact. If performing some action or being referenced by another resource, use the
RelatedPerson
is
based
on
whether:
The
person/animal
operates
on
behalf
of
the
care
delivery
organization
over
multiple
patients
(Practitioner)
or,
Where
the
person/animal
is
not
associated
with
the
organization,
and
instead
is
allocated
tasks
specifically
for
the
RelatedPerson's
Patient
(RelatedPerson).
A
standard
extension
resource.
The primary distinction between a Practitioner and a RelatedPerson is based on whether:
A standard extension
animalSpecies
can
be
used
to
indicate
the
species
of
a
service
animal.
can be used to indicate the species of a service animal.
Practitioner performs different roles within the same or even different organizations. Depending on jurisdiction and custom, it may be necessary to maintain a specific Practitioner Resource for each such role or have a single Practitioner with multiple roles. The role can be limited to a specific period, after which authorization for this role ends. Note that the represented organization need not necessarily be the (direct) employer of a Practitioner.
This resource is referenced by
Account
,
,
AllergyIntolerance
,
,
Appointment
,
,
AppointmentResponse
,
,
AuditEvent
,
,
Basic
,
,
CarePlan
,
,
CareTeam
,
Claim
,
,
ClaimResponse
,
,
ClinicalImpression
,
,
Communication
,
,
CommunicationRequest
,
,
Composition
,
,
Condition
,
,
Contract
,
,
DetectedIssue
,
,
DiagnosticOrder
,
,
DiagnosticReport
,
,
DocumentManifest
,
,
DocumentReference
,
,
EligibilityRequest
,
,
EligibilityResponse
,
,
Encounter
,
,
EnrollmentRequest
,
,
EnrollmentResponse
,
,
EpisodeOfCare
,
,
ExplanationOfBenefit
,
,
Flag
,
,
Goal
,
,
Group
,
,
GuidanceResponse
,
ImagingExcerpt
,
ImagingObjectSelection
,
,
ImagingStudy
,
,
Immunization
,
,
Linkage
,
List
,
,
Media
,
,
MedicationAdministration
,
,
MedicationDispense
,
,
MedicationOrder
,
,
MedicationStatement
,
,
MessageHeader
,
,
NutritionOrder
,
,
Observation
,
,
Order
,
,
OrderResponse
,
,
Patient
,
,
PaymentNotice
,
,
PaymentReconciliation
,
,
Person
,
,
PractitionerRole
,
Procedure
,
,
ProcedureRequest
,
,
ProcessRequest
,
,
ProcessResponse
,
,
Protocol
,
Provenance
,
,
QuestionnaireResponse
,
,
ReferralRequest
,
,
RiskAssessment
,
,
Schedule
,
,
Specimen
,
,
SupplyDelivery
,
,
SupplyRequest
and
,
Task
and
VisionPrescription
Structure
| Name | Flags | Card. | Type |
|
|---|---|---|---|---|
|
DomainResource |
|
||
|
Σ | 0..* | Identifier |
|
|
Σ | 0..1 | boolean |
|
|
Σ |
|
HumanName |
|
|
Σ | 0..* | ContactPoint |
|
|
Σ | 0..* | Address |
|
|
Σ | 0..1 | code |
AdministrativeGender |
|
Σ | 0..1 | date |
|
|
0..* | Attachment |
|
|
|
0..* | BackboneElement |
|
|
|
0..1 | Reference ( Organization ) |
|
|
|
Σ | 0..1 | CodeableConcept |
PractitionerRole |
|
Σ | 0..* | CodeableConcept |
PractitionerSpecialty |
|
Σ | 0..* | Identifier | Business Identifiers that are specific to a role/location |
![]() ![]() ![]() | Σ | 0..* | ContactPoint | Contact details that are specific to the role/location/service |
![]() ![]() ![]() | Σ | 0..1 | Period |
|
|
0..* | Reference ( Location ) |
|
|
|
0..* | Reference ( HealthcareService ) |
|
|
|
0..* | BackboneElement |
|
|
|
0..* | Identifier |
|
|
|
1..1 | CodeableConcept |
|
|
|
0..1 | Period |
|
|
|
0..1 | Reference ( Organization ) |
|
|
|
0..* | CodeableConcept |
|
|
Documentation for this format
|
||||
UML
Diagram
UML Diagram
XML
Template
XML Template
<Practitioner xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier A identifier for the person as this agent --></identifier> <active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use -->
<</name> <</telecom> <</address><name><!-- 0..* HumanName The name(s) associated with the practitioner --></name> <telecom><!-- 0..* ContactPoint A contact detail for the practitioner (that apply to all roles) --></telecom> <address><!-- 0..* Address Address(es) of the practitioner that are not role specific (typically home address) --></address> <gender value="[code]"/><!-- 0..1 male | female | other | unknown --> <birthDate value="[date]"/><!-- 0..1 The date on which the practitioner was born --> <photo><!-- 0..* Attachment Image of the person --></photo> <practitionerRole> <!-- 0..* Roles/organizations the practitioner is associated with --><</managingOrganization><organization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></organization> <role><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></role> <specialty><!-- 0..* CodeableConcept Specific specialty of the practitioner --></specialty> <identifier><!-- 0..* Identifier Business Identifiers that are specific to a role/location --></identifier> <telecom><!-- 0..* ContactPoint Contact details that are specific to the role/location/service --></telecom> <period><!-- 0..1 Period The period during which the practitioner is authorized to perform in these role(s) --></period> <location><!-- 0..* Reference(Location) The location(s) at which this practitioner provides care --></location> <healthcareService><!-- 0..* Reference(HealthcareService) The list of healthcare services that this worker provides for this role's Organization/Location(s) --></healthcareService> </practitionerRole> <qualification> <!-- 0..* Qualifications obtained by training and certification --> <identifier><!-- 0..* Identifier An identifier for this qualification for the practitioner --></identifier> <code><!-- 1..1 CodeableConcept Coded representation of the qualification --></code> <period><!-- 0..1 Period Period during which the qualification is valid --></period> <issuer><!-- 0..1 Reference(Organization) Organization that regulates and issues the qualification --></issuer> </qualification> <communication><!-- 0..* CodeableConcept A language the practitioner is able to use in patient communication--></communication> </Practitioner>
JSON
Template
JSON Template
{
"resourceType" : "Practitioner",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // A identifier for the person as this agent
"active" : <boolean>, // Whether this practitioner's record is in active use
"
"
"
"name" : [{ HumanName }], // The name(s) associated with the practitioner
"telecom" : [{ ContactPoint }], // A contact detail for the practitioner (that apply to all roles)
"address" : [{ Address }], // Address(es) of the practitioner that are not role specific (typically home address)
"gender" : "<code>", // male | female | other | unknown
"birthDate" : "<date>", // The date on which the practitioner was born
"photo" : [{ Attachment }], // Image of the person
"practitionerRole" : [{ // Roles/organizations the practitioner is associated with
"
"organization" : { Reference(Organization) }, // Organization where the roles are performed
"role" : { CodeableConcept }, // Roles which this practitioner may perform
"specialty" : [{ CodeableConcept }], // Specific specialty of the practitioner
"identifier" : [{ Identifier }], // Business Identifiers that are specific to a role/location
"telecom" : [{ ContactPoint }], // Contact details that are specific to the role/location/service
"period" : { Period }, // The period during which the practitioner is authorized to perform in these role(s)
"location" : [{ Reference(Location) }], // The location(s) at which this practitioner provides care
"healthcareService" : [{ Reference(HealthcareService) }] // The list of healthcare services that this worker provides for this role's Organization/Location(s)
}],
"qualification" : [{ // Qualifications obtained by training and certification
"identifier" : [{ Identifier }], // An identifier for this qualification for the practitioner
"code" : { CodeableConcept }, // R! Coded representation of the qualification
"period" : { Period }, // Period during which the qualification is valid
"issuer" : { Reference(Organization) } // Organization that regulates and issues the qualification
}],
"communication" : [{ CodeableConcept }] // A language the practitioner is able to use in patient communication
}
Structure
| Name | Flags | Card. | Type |
|
|---|---|---|---|---|
|
DomainResource |
|
||
|
Σ | 0..* | Identifier |
|
|
Σ | 0..1 | boolean |
|
|
Σ |
|
HumanName |
|
|
Σ | 0..* | ContactPoint |
|
|
Σ | 0..* | Address |
|
|
Σ | 0..1 | code |
AdministrativeGender |
|
Σ | 0..1 | date |
|
|
0..* | Attachment |
|
|
|
0..* | BackboneElement |
|
|
|
0..1 | Reference ( Organization ) |
|
|
|
Σ | 0..1 | CodeableConcept |
PractitionerRole |
|
Σ | 0..* | CodeableConcept |
PractitionerSpecialty |
|
Σ | 0..* | Identifier | Business Identifiers that are specific to a role/location |
![]() ![]() ![]() | Σ | 0..* | ContactPoint | Contact details that are specific to the role/location/service |
![]() ![]() ![]() | Σ | 0..1 | Period |
|
|
0..* | Reference ( Location ) |
|
|
|
0..* | Reference ( HealthcareService ) |
|
|
|
0..* | BackboneElement |
|
|
|
0..* | Identifier |
|
|
|
1..1 | CodeableConcept |
|
|
|
0..1 | Period |
|
|
|
0..1 | Reference ( Organization ) |
|
|
|
0..* | CodeableConcept |
|
|
Documentation for this format
|
||||
XML
Template
XML Template
<Practitioner xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier A identifier for the person as this agent --></identifier> <active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use -->
<</name> <</telecom> <</address><name><!-- 0..* HumanName The name(s) associated with the practitioner --></name> <telecom><!-- 0..* ContactPoint A contact detail for the practitioner (that apply to all roles) --></telecom> <address><!-- 0..* Address Address(es) of the practitioner that are not role specific (typically home address) --></address> <gender value="[code]"/><!-- 0..1 male | female | other | unknown --> <birthDate value="[date]"/><!-- 0..1 The date on which the practitioner was born --> <photo><!-- 0..* Attachment Image of the person --></photo> <practitionerRole> <!-- 0..* Roles/organizations the practitioner is associated with --><</managingOrganization><organization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></organization> <role><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></role> <specialty><!-- 0..* CodeableConcept Specific specialty of the practitioner --></specialty> <identifier><!-- 0..* Identifier Business Identifiers that are specific to a role/location --></identifier> <telecom><!-- 0..* ContactPoint Contact details that are specific to the role/location/service --></telecom> <period><!-- 0..1 Period The period during which the practitioner is authorized to perform in these role(s) --></period> <location><!-- 0..* Reference(Location) The location(s) at which this practitioner provides care --></location> <healthcareService><!-- 0..* Reference(HealthcareService) The list of healthcare services that this worker provides for this role's Organization/Location(s) --></healthcareService> </practitionerRole> <qualification> <!-- 0..* Qualifications obtained by training and certification --> <identifier><!-- 0..* Identifier An identifier for this qualification for the practitioner --></identifier> <code><!-- 1..1 CodeableConcept Coded representation of the qualification --></code> <period><!-- 0..1 Period Period during which the qualification is valid --></period> <issuer><!-- 0..1 Reference(Organization) Organization that regulates and issues the qualification --></issuer> </qualification> <communication><!-- 0..* CodeableConcept A language the practitioner is able to use in patient communication--></communication> </Practitioner>
JSON
Template
JSON Template
{
"resourceType" : "Practitioner",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // A identifier for the person as this agent
"active" : <boolean>, // Whether this practitioner's record is in active use
"
"
"
"name" : [{ HumanName }], // The name(s) associated with the practitioner
"telecom" : [{ ContactPoint }], // A contact detail for the practitioner (that apply to all roles)
"address" : [{ Address }], // Address(es) of the practitioner that are not role specific (typically home address)
"gender" : "<code>", // male | female | other | unknown
"birthDate" : "<date>", // The date on which the practitioner was born
"photo" : [{ Attachment }], // Image of the person
"practitionerRole" : [{ // Roles/organizations the practitioner is associated with
"
"organization" : { Reference(Organization) }, // Organization where the roles are performed
"role" : { CodeableConcept }, // Roles which this practitioner may perform
"specialty" : [{ CodeableConcept }], // Specific specialty of the practitioner
"identifier" : [{ Identifier }], // Business Identifiers that are specific to a role/location
"telecom" : [{ ContactPoint }], // Contact details that are specific to the role/location/service
"period" : { Period }, // The period during which the practitioner is authorized to perform in these role(s)
"location" : [{ Reference(Location) }], // The location(s) at which this practitioner provides care
"healthcareService" : [{ Reference(HealthcareService) }] // The list of healthcare services that this worker provides for this role's Organization/Location(s)
}],
"qualification" : [{ // Qualifications obtained by training and certification
"identifier" : [{ Identifier }], // An identifier for this qualification for the practitioner
"code" : { CodeableConcept }, // R! Coded representation of the qualification
"period" : { Period }, // Period during which the qualification is valid
"issuer" : { Reference(Organization) } // Organization that regulates and issues the qualification
}],
"communication" : [{ CodeableConcept }] // A language the practitioner is able to use in patient communication
}
Alternate
definitions:
Alternate definitions:
Schema
/
Schematron
,
Resource
Profile
(
, Resource Profile (
XML
,
,
JSON
),
),
Questionnaire
| Path | Definition | Type | Reference |
|---|---|---|---|
|
|
|
Required | AdministrativeGender |
|
|
|
Example | PractitionerRole |
|
|
|
Example | PractitionerSpecialty |
|
|
|
Example |
|
|
|
|
Required |
|
Search parameters for this resource. The
common parameters
also apply. See
Searching
for
more
information
about
searching
in
REST,
messaging,
and
services.
for more information about searching in REST, messaging, and services.
| Name | Type | Description | Paths |
| address | string |
|
Practitioner.address |
| address-city | string |
|
Practitioner.address.city |
| address-country | string |
|
Practitioner.address.country |
| address-postalcode | string |
|
Practitioner.address.postalCode |
| address-state | string |
|
Practitioner.address.state |
| address-use | token |
|
Practitioner.address.use |
| communication | token |
|
Practitioner.communication |
| token |
|
|
|
| family | string |
|
Practitioner.name.family |
| gender | token |
|
Practitioner.gender |
| given | string |
|
Practitioner.name.given |
| identifier | token |
|
|
| location | reference |
|
Practitioner.practitionerRole.location
( Location ) |
| name | string |
|
Practitioner.name |
| organization | reference |
|
( Organization ) |
| phone | token |
|
|
| phonetic | string |
|
Practitioner.name |
| role | token |
|
Practitioner.practitionerRole.role |
| specialty | token |
|
Practitioner.practitionerRole.specialty |
| telecom | token |
|
|