This
page
is
part
of
the
Continuous
Integration
Build
of
FHIR
Specification
(v4.0.1:
R4
-
Mixed
Normative
and
STU
)
in
it's
permanent
home
(it
will
always
(will
be
available
incorrect/inconsistent
at
this
URL).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
Responsible
Owner:
Patient
Administration
Work
Group
|
|
Security Category : Individual | Compartments : Practitioner |
A
person
who
is
directly
or
indirectly
involved
in
the
provisioning
of
healthcare.
healthcare
or
related
services.
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 Practitioner resource is used for anyone involved in the provision of care or services to a Patient associated with an organization. The RelatedPerson resource is used for anyone involved in the care for a patient, typically having a personal *relationship *or non-healthcare-specific professional relationship to the patient.
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 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.
The PractitionerRole resource provides the details of roles that the practitioner is approved to perform for which organizations (and at which locations, and optionally what services too).
Practitioners are also often grouped into CareTeams independently of roles, where the CareTeam defines what specific role that they are fulfilling within the team, and might or might not have actual practitioner role resources created for the practitioner (and in the care team context, the organization the practitioner is representing)
When an autonomous system or machine is an actor or participant, the Device resource should be used to represent that system. This would include artificial intelligence or machine learning (AI/ML) systems, as well as other automated systems.
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.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
||||
|---|---|---|---|---|---|---|---|---|
|
|
DomainResource |
A
person
with
a
formal
responsibility
in
the
provisioning
of
healthcare
or
related
services
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|||||
|
Σ | 0..* | Identifier |
An
identifier
for
the
person
as
this
agent
|
||||
|
?! Σ | 0..1 | boolean |
Whether
this
practitioner's
record
is
in
active
use
|
||||
|
Σ | 0..* | HumanName |
The
name(s)
associated
with
the
practitioner
|
||||
|
Σ | 0..* | ContactPoint |
A
contact
detail
for
the
practitioner
(that
apply
to
all
roles)
|
||||
|
Σ | 0..1 |
code
|
male
|
female
|
other
|
unknown
Binding: AdministrativeGender ( Required ) |
||||
|
| 0..1 | date |
The
date
on
which
the
practitioner
|
||||
|
?! Σ | 0..1 |
Indicates
if
the
practitioner
is
deceased
or
not
|
|||||
|
|
|
boolean
|
|||||
|
|
|
||||||
|
| 0..* | Address |
Address(es)
of
the
practitioner
|
||||
|
0..* | Attachment |
Image
of
the
person
|
|||||
|
0..* | BackboneElement |
Qualifications,
certifications,
accreditations,
licenses,
|
|||||
|
0..* | Identifier |
An
identifier
for
this
qualification
for
the
practitioner
|
|||||
|
1..1 | CodeableConcept |
Coded
representation
of
the
qualification
Binding: hl7VS-degreeLicenseCertificate
|
|||||
|
0..1 | CodeableConcept |
Status/progress
of
the
qualification
Binding: Qualification Status ( Preferred ) |
|||||
| 0..1 | Period |
Period
during
which
the
qualification
is
valid
|
|||||
|
0..1 | Reference ( Organization ) |
Organization
that
regulates
and
issues
the
qualification
|
|||||
|
0..* | BackboneElement |
A
language
which
may
be
used
to
communicate
with
the
practitioner
|
|||||
| 1..1 | CodeableConcept |
The
language
code
used
to
communicate
with
the
practitioner
Binding: All Languages ( Required )
|
|||||
|
0..1 | boolean |
Language
preference
indicator
|
|||||
Documentation
for
this
format
|
||||||||
See the Extensions for this resource
UML Diagram ( Legend )
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 An identifier for the person as this agent --></identifier>
<<active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use --> <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><<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent." class="dict"></address><gender value="[code]"/><!-- 0..1 male | female | other | unknown --> <birthDate value="[date]"/><!-- 0..1 The date on which the practitioner was born --> <deceased[x]><!-- 0..1 boolean|dateTime Indicates if the practitioner is deceased or not --></deceased[x]> <address><!-- 0..* Address Address(es) of the practitioner that are not role specific (typically home address) --></address> <photo><!-- 0..* Attachment Image of the person --></photo>< <</identifier> <</code><qualification> <!-- 0..* Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care --> <identifier><!-- 0..* Identifier An identifier for this qualification for the practitioner --></identifier> <code><!-- 1..1 CodeableConcept Coded representation of the qualification--></code> <status><!-- 0..1 CodeableConcept Status/progress of the qualification --></status> <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><communication> <!-- 0..* A language which may be used to communicate with the practitioner --> <language><!-- 1..1 CodeableConcept The language code used to communicate with the practitioner --></language> <preferred value="[boolean]"/><!-- 0..1 Language preference indicator --> </communication> </Practitioner>
JSON Template
{
"resourceType" : "",
"resourceType" : "Practitioner",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // An 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)
"<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address).
Work addresses are not typically entered in this property as they are usually role dependent." class="dict">address
"gender" : "<code>", // male | female | other | unknown
"birthDate" : "<date>", // The date on which the practitioner was born
// deceased[x]: Indicates if the practitioner is deceased or not. One of these 2:
"deceasedBoolean" : <boolean>,
"deceasedDateTime" : "<dateTime>",
"address" : [{ Address }], // Address(es) of the practitioner that are not role specific (typically home address)
"photo" : [{ Attachment }], // Image of the person
"
"
"
"qualification" : [{ // Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
"identifier" : [{ Identifier }], // An identifier for this qualification for the practitioner
"code" : { CodeableConcept }, // R! Coded representation of the qualification
"status" : { CodeableConcept }, // Status/progress of the qualification
"period" : { Period }, // Period during which the qualification is valid
"issuer" : { Reference(Organization) } // Organization that regulates and issues the qualification
}],
"
"communication" : [{ // A language which may be used to communicate with the practitioner
"language" : { CodeableConcept }, // R! The language code used to communicate with the practitioner
"preferred" : <boolean> // Language preference indicator
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .![]()
[ a fhir:;[ a fhir:Practitioner; fhir:nodeRole fhir:treeRoot; # if this is the parser root# from # from fhir: fhir: fhir: fhir: fhir:<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent." class="dict">Practitioner.address fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: ], ...; fhir:# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* An identifier for the person as this agent fhir:active [ boolean ] ; # 0..1 Whether this practitioner's record is in active use fhir:name ( [ HumanName ] ... ) ; # 0..* The name(s) associated with the practitioner fhir:telecom ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the practitioner (that apply to all roles) fhir:gender [ code ] ; # 0..1 male | female | other | unknown fhir:birthDate [ date ] ; # 0..1 The date on which the practitioner was born # deceased[x] : 0..1 Indicates if the practitioner is deceased or not. One of these 2 fhir:deceased [ a fhir:Boolean ; boolean ] fhir:deceased [ a fhir:DateTime ; dateTime ] fhir:address ( [ Address ] ... ) ; # 0..* Address(es) of the practitioner that are not role specific (typically home address) fhir:photo ( [ Attachment ] ... ) ; # 0..* Image of the person fhir:qualification ( [ # 0..* Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care fhir:identifier ( [ Identifier ] ... ) ; # 0..* An identifier for this qualification for the practitioner fhir:code [ CodeableConcept ] ; # 1..1 Coded representation of the qualification fhir:status [ CodeableConcept ] ; # 0..1 Status/progress of the qualification fhir:period [ Period ] ; # 0..1 Period during which the qualification is valid fhir:issuer [ Reference(Organization) ] ; # 0..1 Organization that regulates and issues the qualification ] ... ) ; fhir:communication ( [ # 0..* A language which may be used to communicate with the practitioner fhir:language [ CodeableConcept ] ; # 1..1 The language code used to communicate with the practitioner fhir:preferred [ boolean ] ; # 0..1 Language preference indicator ] ... ) ; ]
Changes
since
R3
from
both
R4
and
R4B
| Practitioner | |
| Practitioner.active |
|
|
|
|
| Practitioner.qualification.status |
|
| Practitioner.communication |
|
| Practitioner.communication.language |
|
| Practitioner.communication.preferred |
|
See the Full Difference for further information
This
analysis
is
available
for
R4
as
XML
or
JSON
.
See
R3
<-->
R4
Conversion
Maps
(status
=
14
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.)
for
R4B
as
XML
or
JSON
.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
||||
|---|---|---|---|---|---|---|---|---|
|
|
DomainResource |
A
person
with
a
formal
responsibility
in
the
provisioning
of
healthcare
or
related
services
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|||||
|
Σ | 0..* | Identifier |
An
identifier
for
the
person
as
this
agent
|
||||
|
?! Σ | 0..1 | boolean |
Whether
this
practitioner's
record
is
in
active
use
|
||||
|
Σ | 0..* | HumanName |
The
name(s)
associated
with
the
practitioner
|
||||
|
Σ | 0..* | ContactPoint |
A
contact
detail
for
the
practitioner
(that
apply
to
all
roles)
|
||||
|
Σ | 0..1 | code |
male
|
female
|
other
|
unknown
Binding: AdministrativeGender ( Required ) |
||||
|
| 0..1 | date |
The
date
on
which
the
practitioner
|
||||
|
?! Σ | 0..1 |
Indicates
if
the
practitioner
is
deceased
or
not
|
|||||
|
|
|
boolean
|
|||||
|
|
|
||||||
|
| 0..* | Address |
Address(es)
of
the
practitioner
|
||||
|
0..* | Attachment |
Image
of
the
person
|
|||||
|
0..* | BackboneElement |
Qualifications,
certifications,
accreditations,
licenses,
|
|||||
|
0..* | Identifier |
An
identifier
for
this
qualification
for
the
practitioner
|
|||||
|
1..1 | CodeableConcept |
Coded
representation
of
the
qualification
Binding: hl7VS-degreeLicenseCertificate
|
|||||
|
0..1 | CodeableConcept |
Status/progress
of
the
qualification
Binding: Qualification Status ( Preferred ) |
|||||
| 0..1 | Period |
Period
during
which
the
qualification
is
valid
|
|||||
|
0..1 | Reference ( Organization ) |
Organization
that
regulates
and
issues
the
qualification
|
|||||
|
0..* | BackboneElement |
A
language
which
may
be
used
to
communicate
with
the
practitioner
|
|||||
| 1..1 | CodeableConcept |
The
language
code
used
to
communicate
with
the
practitioner
Binding: All Languages ( Required )
|
|||||
|
0..1 | boolean |
Language
preference
indicator
|
|||||
Documentation
for
this
format
|
||||||||
See the Extensions for this resource
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 An identifier for the person as this agent --></identifier>
<<active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use --> <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><<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent." class="dict"></address><gender value="[code]"/><!-- 0..1 male | female | other | unknown --> <birthDate value="[date]"/><!-- 0..1 The date on which the practitioner was born --> <deceased[x]><!-- 0..1 boolean|dateTime Indicates if the practitioner is deceased or not --></deceased[x]> <address><!-- 0..* Address Address(es) of the practitioner that are not role specific (typically home address) --></address> <photo><!-- 0..* Attachment Image of the person --></photo>< <</identifier> <</code><qualification> <!-- 0..* Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care --> <identifier><!-- 0..* Identifier An identifier for this qualification for the practitioner --></identifier> <code><!-- 1..1 CodeableConcept Coded representation of the qualification--></code> <status><!-- 0..1 CodeableConcept Status/progress of the qualification --></status> <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><communication> <!-- 0..* A language which may be used to communicate with the practitioner --> <language><!-- 1..1 CodeableConcept The language code used to communicate with the practitioner --></language> <preferred value="[boolean]"/><!-- 0..1 Language preference indicator --> </communication> </Practitioner>
JSON Template
{
"resourceType" : "",
"resourceType" : "Practitioner",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // An 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)
"<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address).
Work addresses are not typically entered in this property as they are usually role dependent." class="dict">address
"gender" : "<code>", // male | female | other | unknown
"birthDate" : "<date>", // The date on which the practitioner was born
// deceased[x]: Indicates if the practitioner is deceased or not. One of these 2:
"deceasedBoolean" : <boolean>,
"deceasedDateTime" : "<dateTime>",
"address" : [{ Address }], // Address(es) of the practitioner that are not role specific (typically home address)
"photo" : [{ Attachment }], // Image of the person
"
"
"
"qualification" : [{ // Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
"identifier" : [{ Identifier }], // An identifier for this qualification for the practitioner
"code" : { CodeableConcept }, // R! Coded representation of the qualification
"status" : { CodeableConcept }, // Status/progress of the qualification
"period" : { Period }, // Period during which the qualification is valid
"issuer" : { Reference(Organization) } // Organization that regulates and issues the qualification
}],
"
"communication" : [{ // A language which may be used to communicate with the practitioner
"language" : { CodeableConcept }, // R! The language code used to communicate with the practitioner
"preferred" : <boolean> // Language preference indicator
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .![]()
[ a fhir:;[ a fhir:Practitioner; fhir:nodeRole fhir:treeRoot; # if this is the parser root# from # from fhir: fhir: fhir: fhir: fhir:<a href="practitioner-definitions.html#Practitioner.address" title="Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent." class="dict">Practitioner.address fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: ], ...; fhir:# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* An identifier for the person as this agent fhir:active [ boolean ] ; # 0..1 Whether this practitioner's record is in active use fhir:name ( [ HumanName ] ... ) ; # 0..* The name(s) associated with the practitioner fhir:telecom ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the practitioner (that apply to all roles) fhir:gender [ code ] ; # 0..1 male | female | other | unknown fhir:birthDate [ date ] ; # 0..1 The date on which the practitioner was born # deceased[x] : 0..1 Indicates if the practitioner is deceased or not. One of these 2 fhir:deceased [ a fhir:Boolean ; boolean ] fhir:deceased [ a fhir:DateTime ; dateTime ] fhir:address ( [ Address ] ... ) ; # 0..* Address(es) of the practitioner that are not role specific (typically home address) fhir:photo ( [ Attachment ] ... ) ; # 0..* Image of the person fhir:qualification ( [ # 0..* Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care fhir:identifier ( [ Identifier ] ... ) ; # 0..* An identifier for this qualification for the practitioner fhir:code [ CodeableConcept ] ; # 1..1 Coded representation of the qualification fhir:status [ CodeableConcept ] ; # 0..1 Status/progress of the qualification fhir:period [ Period ] ; # 0..1 Period during which the qualification is valid fhir:issuer [ Reference(Organization) ] ; # 0..1 Organization that regulates and issues the qualification ] ... ) ; fhir:communication ( [ # 0..* A language which may be used to communicate with the practitioner fhir:language [ CodeableConcept ] ; # 1..1 The language code used to communicate with the practitioner fhir:preferred [ boolean ] ; # 0..1 Language preference indicator ] ... ) ; ]
Changes
since
Release
3
from
both
R4
and
R4B
| Practitioner | |
| Practitioner.active |
|
|
|
|
| Practitioner.qualification.status |
|
| Practitioner.communication |
|
| Practitioner.communication.language |
|
| Practitioner.communication.preferred |
|
See the Full Difference for further information
This
analysis
is
available
for
R4
as
XML
or
JSON
.
See
R3
<-->
R4
Conversion
Maps
(status
=
14
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.)
for
R4B
as
XML
or
JSON
.
See
the
Profiles
&
Extensions
and
the
alternate
Additional
definitions:
Master
Definition
XML
+
JSON
,
XML
Schema
/
Schematron
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
the
extensions
,
the
spreadsheet
version
&
the
dependency
analysis
| Path |
|
Type |
|
|---|---|---|---|
| Practitioner.gender |
|
Required |
The gender of a person used for administrative purposes. |
| Practitioner.qualification.code |
(a
valid
code
from
degreeLicenseCertificate
)
|
Example |
Concepts specifying an educational degree (e.g., MD). Used in the CNN datatype (names and identifiers of clinicians) in Version 2 messaging. Used in Version 2 messaging; note that in releases of HL7 prior to 2.3.1, was also used in person names (XPN), but this use was deprecated, then withdrawn in 2.7. |
| Practitioner.qualification.status |
|
Preferred
|
Set of statuses that apply to qualifications of practitioners and organizations |
| Practitioner.communication.language |
AllLanguages
(a
valid
code
from
Tags
for
the
Identification
of
Languages
)
| Required |
This value set includes all possible codes from BCP-47 (see http://tools.ietf.org/html/bcp47) |
|
| starter |
Practitioner.identifier
and/or
Practitioner.qualification.identifier
based
on
local
requirements.
Practitioner.identifier
doesn't
convey
anything
about
the
status
of
the
license
(other
than
period),
if
this
or
any
additional
details
are
available
then
the
qualification.identifier
should
be
used.
Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| active | token | Whether the practitioner record is active | Practitioner.active | |
| address | string | A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text | Practitioner.address |
|
| address-city | string | A city specified in an address | Practitioner.address.city |
|
| address-country | string | A country specified in an address | Practitioner.address.country |
|
| address-postalcode | string | A postalCode specified in an address | Practitioner.address.postalCode |
|
| address-state | string | A state specified in an address | Practitioner.address.state |
|
| address-use | token | A use code specified in an address | Practitioner.address.use |
|
| communication | token |
|
|
|
| death-date | date | The date of death has been provided and satisfies this search value | (Practitioner.deceased.ofType(dateTime)) | |
| deceased | token | This Practitioner has been marked as deceased, or has a death date entered | Practitioner.deceased.exists() and Practitioner.deceased != false | |
| token | A value in an email contact | Practitioner.telecom.where(system='email') |
|
|
| family | string | A portion of the family name | Practitioner.name.family |
|
| gender | token | Gender of the practitioner | Practitioner.gender |
|
| given | string | A portion of the given name | Practitioner.name.given |
|
| identifier | token | A practitioner's Identifier | Practitioner.identifier | Practitioner.qualification.identifier | |
| name | string | A server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or text | Practitioner.name | |
| phone | token | A value in a phone contact | Practitioner.telecom.where(system='phone') |
|
| phonetic | string | A portion of either family or given name using some kind of phonetic matching algorithm | Practitioner.name |
|
| qual-code-period |
composite
|
The practitioner has a qualification during a specific period |
On
Practitioner.qualification:
qualification-code: code qualification-period: period | |
| qualification-code | token | The type of qualification | Practitioner.qualification.code | |
| qualification-period | date | The date(s) a qualification is valid for | Practitioner.qualification.period | |
| telecom | token | The value in any kind of contact | Practitioner.telecom |
|