STU 3 Candidate

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 . Page versions: R5 R4B R4 R3 R2

5.4 Resource Practitioner - Content

Patient Administration Work GroupMaturity Level: 1Compartments: Practitioner

A person who is directly or indirectly involved in the provisioning of healthcare.

5.4.1 Scope and Usage

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):

  • physicians, dentists, pharmacists
  • physician assistants, nurses, scribes
  • midwives, dietitians, therapists, optometrists, paramedics
  • medical technicians, laboratory scientists, prosthetic technicians, radiographers
  • social workers, professional home carers, official volunteers
  • receptionists handling patient registration
  • IT personnel merging or unmerging patient records
  • Service animal (e.g., ward assigned dog capable of detecting cancer in patients)

5.4.2 Boundaries and Relationships

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:

  • 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 animalSpecies can be used to indicate the species of a service animal.

5.4.3 Background and Context

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, Task and VisionPrescription

5.4.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner DomainResourceA person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ0..*IdentifierA identifier for the person as this agent
... active Σ0..1booleanWhether this practitioner's record is in active use
... name Σ0..*HumanNameThe name(s) associated with the practitioner
... telecom Σ0..*ContactPointA contact detail for the practitioner (that apply to all roles)
... address Σ0..*AddressAddress(es) of the practitioner that are not role specific (typically home address)
... gender Σ0..1codemale | female | other | unknown
AdministrativeGender (Required)
... birthDate Σ0..1dateThe date on which the practitioner was born
... photo 0..*AttachmentImage of the person
... practitionerRole 0..*BackboneElementRoles/organizations the practitioner is associated with
.... organization 0..1Reference(Organization)Organization where the roles are performed
.... role Σ0..1CodeableConceptRoles which this practitioner may perform
PractitionerRole (Example)
.... specialty Σ0..*CodeableConceptSpecific specialty of the practitioner
PractitionerSpecialty (Example)
.... identifier Σ0..*IdentifierBusiness Identifiers that are specific to a role/location
.... telecom Σ0..*ContactPointContact details that are specific to the role/location/service
.... period Σ0..1PeriodThe period during which the practitioner is authorized to perform in these role(s)
.... location 0..*Reference(Location)The location(s) at which this practitioner provides care
.... healthcareService 0..*Reference(HealthcareService)The list of healthcare services that this worker provides for this role's Organization/Location(s)
... qualification 0..*BackboneElementQualifications obtained by training and certification
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 (Example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1Reference(Organization)Organization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Language (Required)

doco Documentation for this format

UML Diagram

Practitioner (DomainResource)An identifier that applies to this person in this roleidentifier : Identifier [0..*]Whether this practitioner's record is in active useactive : boolean [0..1]The name(s) associated with the practitionername : HumanName [0..*]A contact detail for the practitioner, e.g. a telephone number or an email addresstelecom : ContactPoint [0..*]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 dependentaddress : Address [0..*]Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code [0..1] « The gender of a person used for administrative purposes. (Strength=Required)AdministrativeGender! »The date of birth for the practitionerbirthDate : date [0..1]Image of the personphoto : Attachment [0..*]A language the practitioner is able to use in patient communicationcommunication : CodeableConcept [0..*] « A human language. (Strength=Required)Language! »PractitionerRoleThe organization where the Practitioner performs the roles associatedorganization : Reference [0..1] « Organization »Roles which this practitioner is authorized to perform for the organizationrole : CodeableConcept [0..1] « The role a person plays representing an organization (Strength=Example)PractitionerRole?? »Specific specialty of the practitionerspecialty : CodeableConcept [0..*] « Specific specialty associated with the agency (Strength=Example)PractitionerSpecialty?? »Business Identifiers that are specific to a role/locationidentifier : Identifier [0..*]Contact details that are specific to the role/location/servicetelecom : ContactPoint [0..*]The period during which the person is authorized to act as a practitioner in these role(s) for the organizationperiod : Period [0..1]The location(s) at which this practitioner provides carelocation : Reference [0..*] « Location »The list of healthcare services that this worker provides for this role's Organization/Location(s)healthcareService : Reference [0..*] « HealthcareService »QualificationAn identifier that applies to this person's qualification in this roleidentifier : Identifier [0..*]Coded representation of the qualificationcode : CodeableConcept [1..1] « Specific qualification the practitioner has to provide a service (Strength=Example)ANZSCO -- Australian and New ...?? »Period during which the qualification is validperiod : Period [0..1]Organization that regulates and issues the qualificationissuer : Reference [0..1] « Organization »The list of roles/organizations that the practitioner is associated withpractitionerRole[0..*]Qualifications obtained by training and certificationqualification[0..*]

XML Template

<Practitioner xmlns="http://hl7.org/fhir"> doco
 <!-- 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><!-- 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 -->
  <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

{doco
  "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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner DomainResourceA person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ0..*IdentifierA identifier for the person as this agent
... active Σ0..1booleanWhether this practitioner's record is in active use
... name Σ0..*HumanNameThe name(s) associated with the practitioner
... telecom Σ0..*ContactPointA contact detail for the practitioner (that apply to all roles)
... address Σ0..*AddressAddress(es) of the practitioner that are not role specific (typically home address)
... gender Σ0..1codemale | female | other | unknown
AdministrativeGender (Required)
... birthDate Σ0..1dateThe date on which the practitioner was born
... photo 0..*AttachmentImage of the person
... practitionerRole 0..*BackboneElementRoles/organizations the practitioner is associated with
.... organization 0..1Reference(Organization)Organization where the roles are performed
.... role Σ0..1CodeableConceptRoles which this practitioner may perform
PractitionerRole (Example)
.... specialty Σ0..*CodeableConceptSpecific specialty of the practitioner
PractitionerSpecialty (Example)
.... identifier Σ0..*IdentifierBusiness Identifiers that are specific to a role/location
.... telecom Σ0..*ContactPointContact details that are specific to the role/location/service
.... period Σ0..1PeriodThe period during which the practitioner is authorized to perform in these role(s)
.... location 0..*Reference(Location)The location(s) at which this practitioner provides care
.... healthcareService 0..*Reference(HealthcareService)The list of healthcare services that this worker provides for this role's Organization/Location(s)
... qualification 0..*BackboneElementQualifications obtained by training and certification
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 (Example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1Reference(Organization)Organization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Language (Required)

doco Documentation for this format

UML Diagram

Practitioner (DomainResource)An identifier that applies to this person in this roleidentifier : Identifier [0..*]Whether this practitioner's record is in active useactive : boolean [0..1]The name(s) associated with the practitionername : HumanName [0..*]A contact detail for the practitioner, e.g. a telephone number or an email addresstelecom : ContactPoint [0..*]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 dependentaddress : Address [0..*]Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code [0..1] « The gender of a person used for administrative purposes. (Strength=Required)AdministrativeGender! »The date of birth for the practitionerbirthDate : date [0..1]Image of the personphoto : Attachment [0..*]A language the practitioner is able to use in patient communicationcommunication : CodeableConcept [0..*] « A human language. (Strength=Required)Language! »PractitionerRoleThe organization where the Practitioner performs the roles associatedorganization : Reference [0..1] « Organization »Roles which this practitioner is authorized to perform for the organizationrole : CodeableConcept [0..1] « The role a person plays representing an organization (Strength=Example)PractitionerRole?? »Specific specialty of the practitionerspecialty : CodeableConcept [0..*] « Specific specialty associated with the agency (Strength=Example)PractitionerSpecialty?? »Business Identifiers that are specific to a role/locationidentifier : Identifier [0..*]Contact details that are specific to the role/location/servicetelecom : ContactPoint [0..*]The period during which the person is authorized to act as a practitioner in these role(s) for the organizationperiod : Period [0..1]The location(s) at which this practitioner provides carelocation : Reference [0..*] « Location »The list of healthcare services that this worker provides for this role's Organization/Location(s)healthcareService : Reference [0..*] « HealthcareService »QualificationAn identifier that applies to this person's qualification in this roleidentifier : Identifier [0..*]Coded representation of the qualificationcode : CodeableConcept [1..1] « Specific qualification the practitioner has to provide a service (Strength=Example)ANZSCO -- Australian and New ...?? »Period during which the qualification is validperiod : Period [0..1]Organization that regulates and issues the qualificationissuer : Reference [0..1] « Organization »The list of roles/organizations that the practitioner is associated withpractitionerRole[0..*]Qualifications obtained by training and certificationqualification[0..*]

XML Template

<Practitioner xmlns="http://hl7.org/fhir"> doco
 <!-- 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><!-- 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 -->
  <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

{doco
  "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: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

5.4.4.1 Terminology Bindings

PathDefinitionTypeReference
Practitioner.gender The gender of a person used for administrative purposes.RequiredAdministrativeGender
Practitioner.practitionerRole.role The role a person plays representing an organizationExamplePractitionerRole
Practitioner.practitionerRole.specialty Specific specialty associated with the agencyExamplePractitionerSpecialty
Practitioner.qualification.code Specific qualification the practitioner has to provide a serviceExampleANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2
Practitioner.communication A human language.RequiredIETF language tag

5.4.5 Notes:

  • Practitioner.period is different from Qualification.period: the first concerns the period during which the Practitioner is allowed to perform in the given roles for the organization. The second is about the period of validity for qualifications for which licenses have been obtained by training or otherwise.

5.4.6 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
addressstringAn address in any kind of address/partPractitioner.address
address-citystringA city specified in an addressPractitioner.address.city
address-countrystringA country specified in an addressPractitioner.address.country
address-postalcodestringA postalCode specified in an addressPractitioner.address.postalCode
address-statestringA state specified in an addressPractitioner.address.state
address-usetokenA use code specified in an addressPractitioner.address.use
communicationtokenOne of the languages that the practitioner can communicate withPractitioner.communication
emailtokenA value in an email contactPractitioner.telecom(system=email), Practitioner.practitionerRole.telecom(system=email)
familystringA portion of the family namePractitioner.name.family
gendertokenGender of the practitionerPractitioner.gender
givenstringA portion of the given namePractitioner.name.given
identifiertokenA practitioner's IdentifierPractitioner.identifier, Practitioner.practitionerRole.identifier
locationreferenceOne of the locations at which this practitioner provides carePractitioner.practitionerRole.location
(Location)
namestringA portion of either family or given namePractitioner.name
organizationreferenceThe identity of the organization the practitioner represents / acts on behalf ofPractitioner.practitionerRole.organization
(Organization)
phonetokenA value in a phone contactPractitioner.telecom(system=phone), Practitioner.practitionerRole.telecom(system=phone)
phoneticstringA portion of either family or given name using some kind of phonetic matching algorithmPractitioner.name
roletokenThe practitioner can perform this role at for the organizationPractitioner.practitionerRole.role
specialtytokenThe practitioner has this specialty at an organizationPractitioner.practitionerRole.specialty
telecomtokenThe value in any kind of contactPractitioner.telecom, Practitioner.practitionerRole.telecom