This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). 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

8.4 Resource Practitioner - Content

Patient Administration

Work Group

Maturity Level: 1

Compartments: Practitioner

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

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

8.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.

8.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, Consent, Contract, DetectedIssue, DeviceUseRequest, DiagnosticReport, DiagnosticRequest, DocumentManifest, DocumentReference, EligibilityRequest, EligibilityResponse, Encounter, EnrollmentRequest, EnrollmentResponse, EpisodeOfCare, ExplanationOfBenefit, Flag, Goal, Group, ImagingManifest, ImagingStudy, Immunization, Linkage, List, Media, MedicationAdministration, MedicationDispense, MedicationRequest, MedicationStatement, MessageHeader, NutritionRequest, Observation, Patient, PaymentNotice, PaymentReconciliation, Person, PractitionerRole, Procedure, ProcedureRequest, ProcessRequest, ProcessResponse, Provenance, QuestionnaireResponse, ReferralRequest, RequestGroup, ResearchStudy, RiskAssessment, Schedule, Specimen, SupplyDelivery, SupplyRequest, Task and VisionPrescription

Structure

Name	Flags	Card.	Type	Description & Constraints
Practitioner			DomainResource	A person with a formal responsibility in the provisioning of healthcare or related services
identifier	Σ	0..*	Identifier	A identifier for the person as this agent
active	Σ	0..1	boolean	Whether this practitioner's record is in active use
name	Σ	0..*	HumanName	The name(s) associated with the practitioner
telecom	Σ	0..*	ContactPoint	A contact detail for the practitioner (that apply to all roles)
address	Σ	0..*	Address	Address(es) of the practitioner that are not role specific (typically home address)
gender	Σ	0..1	code	male \| female \| other \| unknown AdministrativeGender (Required)
birthDate	Σ	0..1	date	The date on which the practitioner was born
photo		0..*	Attachment	Image of the person
role		0..*	BackboneElement	Roles/organizations the practitioner is associated with
organization		0..1	Reference(Organization)	Organization where the roles are performed
code	Σ	0..1	CodeableConcept	Roles which this practitioner may perform PractitionerRole (Example)
specialty	Σ	0..*	CodeableConcept	Specific specialty of the practitioner PractitionerSpecialty (Example)
identifier	Σ	0..*	Identifier	Business Identifiers that are specific to a role/location
telecom	Σ	0..*	ContactPoint	Contact details that are specific to the role/location/service
period	Σ	0..1	Period	The 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)
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for the PractitonerRole
qualification		0..*	BackboneElement	Qualifications obtained by training and certification
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code		1..1	CodeableConcept	Coded representation of the qualification ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 (Example)
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Organization that regulates and issues the qualification
communication		0..*	CodeableConcept	A language the practitioner is able to use in patient communication Common Languages (Extensible but limited to All Languages)
Documentation for this format

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 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>
 <role>  <!-- 0..* Roles/organizations the practitioner is associated with -->
  <organization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></organization>
  <code><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></code>
  <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>
  <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the PractitonerRole --></endpoint>
 </role>
 <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

{
  "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
  "role" : [{ // Roles/organizations the practitioner is associated with
    "organization" : { Reference(Organization) }, // Organization where the roles are performed
    "code" : { 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)
    "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the PractitonerRole
  }],
  "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
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:Practitioner;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Practitioner.identifier [ Identifier ], ... ; # 0..* A identifier for the person as this agent
  fhir:Practitioner.active [ boolean ]; # 0..1 Whether this practitioner's record is in active use
  fhir:Practitioner.name [ HumanName ], ... ; # 0..* The name(s) associated with the practitioner
  fhir:Practitioner.telecom [ ContactPoint ], ... ; # 0..* A contact detail for the practitioner (that apply to all roles)
  fhir:Practitioner.address [ Address ], ... ; # 0..* Address(es) of the practitioner that are not role specific (typically home address)
  fhir:Practitioner.gender [ code ]; # 0..1 male | female | other | unknown
  fhir:Practitioner.birthDate [ date ]; # 0..1 The date  on which the practitioner was born
  fhir:Practitioner.photo [ Attachment ], ... ; # 0..* Image of the person
  fhir:Practitioner.role [ # 0..* Roles/organizations the practitioner is associated with
    fhir:Practitioner.role.organization [ Reference(Organization) ]; # 0..1 Organization where the roles are performed
    fhir:Practitioner.role.code [ CodeableConcept ]; # 0..1 Roles which this practitioner may perform
    fhir:Practitioner.role.specialty [ CodeableConcept ], ... ; # 0..* Specific specialty of the practitioner
    fhir:Practitioner.role.identifier [ Identifier ], ... ; # 0..* Business Identifiers that are specific to a role/location
    fhir:Practitioner.role.telecom [ ContactPoint ], ... ; # 0..* Contact details that are specific to the role/location/service
    fhir:Practitioner.role.period [ Period ]; # 0..1 The period during which the practitioner is authorized to perform in these role(s)
    fhir:Practitioner.role.location [ Reference(Location) ], ... ; # 0..* The location(s) at which this practitioner provides care
    fhir:Practitioner.role.healthcareService [ Reference(HealthcareService) ], ... ; # 0..* The list of healthcare services that this worker provides for this role's Organization/Location(s)
    fhir:Practitioner.role.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the PractitonerRole
  ], ...;
  fhir:Practitioner.qualification [ # 0..* Qualifications obtained by training and certification
    fhir:Practitioner.qualification.identifier [ Identifier ], ... ; # 0..* An identifier for this qualification for the practitioner
    fhir:Practitioner.qualification.code [ CodeableConcept ]; # 1..1 Coded representation of the qualification
    fhir:Practitioner.qualification.period [ Period ]; # 0..1 Period during which the qualification is valid
    fhir:Practitioner.qualification.issuer [ Reference(Organization) ]; # 0..1 Organization that regulates and issues the qualification
  ], ...;
  fhir:Practitioner.communication [ CodeableConcept ], ... ; # 0..* A language the practitioner is able to use in patient communication
]

Changes since DSTU2

Practitioner

Practitioner.name

Max Cardinality changed from 1 to *

Practitioner.role

Renamed from practitionerRole to role

Practitioner.role.organization

Renamed from managingOrganization to organization

Practitioner.role.code

Renamed from role to code

Practitioner.role.identifier

added Element

Practitioner.role.telecom

added Element

Practitioner.role.endpoint

added Element

Practitioner.communication

Change binding strength from required to extensible, Change value set from http://tools.ietf.org/html/bcp47 to http://hl7.org/fhir/ValueSet/languages

See the Full Difference for further information

Structure

Name	Flags	Card.	Type	Description & Constraints
Practitioner			DomainResource	A person with a formal responsibility in the provisioning of healthcare or related services
identifier	Σ	0..*	Identifier	A identifier for the person as this agent
active	Σ	0..1	boolean	Whether this practitioner's record is in active use
name	Σ	0..*	HumanName	The name(s) associated with the practitioner
telecom	Σ	0..*	ContactPoint	A contact detail for the practitioner (that apply to all roles)
address	Σ	0..*	Address	Address(es) of the practitioner that are not role specific (typically home address)
gender	Σ	0..1	code	male \| female \| other \| unknown AdministrativeGender (Required)
birthDate	Σ	0..1	date	The date on which the practitioner was born
photo		0..*	Attachment	Image of the person
role		0..*	BackboneElement	Roles/organizations the practitioner is associated with
organization		0..1	Reference(Organization)	Organization where the roles are performed
code	Σ	0..1	CodeableConcept	Roles which this practitioner may perform PractitionerRole (Example)
specialty	Σ	0..*	CodeableConcept	Specific specialty of the practitioner PractitionerSpecialty (Example)
identifier	Σ	0..*	Identifier	Business Identifiers that are specific to a role/location
telecom	Σ	0..*	ContactPoint	Contact details that are specific to the role/location/service
period	Σ	0..1	Period	The 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)
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for the PractitonerRole
qualification		0..*	BackboneElement	Qualifications obtained by training and certification
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code		1..1	CodeableConcept	Coded representation of the qualification ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 (Example)
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Organization that regulates and issues the qualification
communication		0..*	CodeableConcept	A language the practitioner is able to use in patient communication Common Languages (Extensible but limited to All Languages)
Documentation for this format

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 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>
 <role>  <!-- 0..* Roles/organizations the practitioner is associated with -->
  <organization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></organization>
  <code><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></code>
  <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>
  <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the PractitonerRole --></endpoint>
 </role>
 <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

{
  "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
  "role" : [{ // Roles/organizations the practitioner is associated with
    "organization" : { Reference(Organization) }, // Organization where the roles are performed
    "code" : { 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)
    "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the PractitonerRole
  }],
  "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
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:Practitioner;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Practitioner.identifier [ Identifier ], ... ; # 0..* A identifier for the person as this agent
  fhir:Practitioner.active [ boolean ]; # 0..1 Whether this practitioner's record is in active use
  fhir:Practitioner.name [ HumanName ], ... ; # 0..* The name(s) associated with the practitioner
  fhir:Practitioner.telecom [ ContactPoint ], ... ; # 0..* A contact detail for the practitioner (that apply to all roles)
  fhir:Practitioner.address [ Address ], ... ; # 0..* Address(es) of the practitioner that are not role specific (typically home address)
  fhir:Practitioner.gender [ code ]; # 0..1 male | female | other | unknown
  fhir:Practitioner.birthDate [ date ]; # 0..1 The date  on which the practitioner was born
  fhir:Practitioner.photo [ Attachment ], ... ; # 0..* Image of the person
  fhir:Practitioner.role [ # 0..* Roles/organizations the practitioner is associated with
    fhir:Practitioner.role.organization [ Reference(Organization) ]; # 0..1 Organization where the roles are performed
    fhir:Practitioner.role.code [ CodeableConcept ]; # 0..1 Roles which this practitioner may perform
    fhir:Practitioner.role.specialty [ CodeableConcept ], ... ; # 0..* Specific specialty of the practitioner
    fhir:Practitioner.role.identifier [ Identifier ], ... ; # 0..* Business Identifiers that are specific to a role/location
    fhir:Practitioner.role.telecom [ ContactPoint ], ... ; # 0..* Contact details that are specific to the role/location/service
    fhir:Practitioner.role.period [ Period ]; # 0..1 The period during which the practitioner is authorized to perform in these role(s)
    fhir:Practitioner.role.location [ Reference(Location) ], ... ; # 0..* The location(s) at which this practitioner provides care
    fhir:Practitioner.role.healthcareService [ Reference(HealthcareService) ], ... ; # 0..* The list of healthcare services that this worker provides for this role's Organization/Location(s)
    fhir:Practitioner.role.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the PractitonerRole
  ], ...;
  fhir:Practitioner.qualification [ # 0..* Qualifications obtained by training and certification
    fhir:Practitioner.qualification.identifier [ Identifier ], ... ; # 0..* An identifier for this qualification for the practitioner
    fhir:Practitioner.qualification.code [ CodeableConcept ]; # 1..1 Coded representation of the qualification
    fhir:Practitioner.qualification.period [ Period ]; # 0..1 Period during which the qualification is valid
    fhir:Practitioner.qualification.issuer [ Reference(Organization) ]; # 0..1 Organization that regulates and issues the qualification
  ], ...;
  fhir:Practitioner.communication [ CodeableConcept ], ... ; # 0..* A language the practitioner is able to use in patient communication
]

Changes since DSTU2

Practitioner

Practitioner.name

Max Cardinality changed from 1 to *

Practitioner.role

Renamed from practitionerRole to role

Practitioner.role.organization

Renamed from managingOrganization to organization

Practitioner.role.code

Renamed from role to code

Practitioner.role.identifier

added Element

Practitioner.role.telecom

added Element

Practitioner.role.endpoint

added Element

Practitioner.communication

Change binding strength from required to extensible, Change value set from http://tools.ietf.org/html/bcp47 to http://hl7.org/fhir/ValueSet/languages

See the Full Difference for further information

Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle), JSON-LD (for RDF as JSON-LD),

8.4.4.1 Terminology Bindings

Path	Definition	Type	Reference
Practitioner.gender	The gender of a person used for administrative purposes.	Required	AdministrativeGender
Practitioner.role.code	The role a person plays representing an organization	Example	PractitionerRole
Practitioner.role.specialty	Specific specialty associated with the agency	Example	PractitionerSpecialty
Practitioner.qualification.code	Specific qualification the practitioner has to provide a service	Example	ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2
Practitioner.communication	A human language.	Extensible, but limited to All Languages	Common Languages

Path

Definition

Type

Reference

Practitioner.gender

The gender of a person used for administrative purposes.

Required

AdministrativeGender

Practitioner.role.code

The role a person plays representing an organization

Example

PractitionerRole

Practitioner.role.specialty

Specific specialty associated with the agency

Example

PractitionerSpecialty

Practitioner.qualification.code

Specific qualification the practitioner has to provide a service

Example

ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2

Practitioner.communication

A human language.

Extensible, but limited to All Languages

Common Languages

8.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.

8.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.

Name	Type	Description	Paths	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, state, country, postalCode, and/or text	Practitioner.address	3 Resources
address-city	string	A city specified in an address	Practitioner.address.city	3 Resources
address-country	string	A country specified in an address	Practitioner.address.country	3 Resources
address-postalcode	string	A postalCode specified in an address	Practitioner.address.postalCode	3 Resources
address-state	string	A state specified in an address	Practitioner.address.state	3 Resources
address-use	token	A use code specified in an address	Practitioner.address.use	3 Resources
communication	token	One of the languages that the practitioner can communicate with	Practitioner.communication
email	token	A value in an email contact	Practitioner.telecom(system=email), Practitioner.role.telecom(system=email)	4 Resources
endpoint	reference	The endpoint of the practitioner for a role at an organization	Practitioner.role.endpoint (Endpoint)
family	string	A portion of the family name	Practitioner.name.family	1 Resources
gender	token	Gender of the practitioner	Practitioner.gender	3 Resources
given	string	A portion of the given name	Practitioner.name.given	1 Resources
identifier	token	A practitioner's Identifier	Practitioner.identifier, Practitioner.role.identifier
location	reference	One of the locations at which this practitioner provides care	Practitioner.role.location (Location)
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
organization	reference	The identity of the organization the practitioner represents / acts on behalf of	Practitioner.role.organization (Organization)
phone	token	A value in a phone contact	Practitioner.telecom(system=phone), Practitioner.role.telecom(system=phone)	4 Resources
phonetic	string	A portion of either family or given name using some kind of phonetic matching algorithm	Practitioner.name	3 Resources
role	token	The practitioner can perform this role at for the organization	Practitioner.role.code
specialty	token	The practitioner has this specialty at an organization	Practitioner.role.specialty
telecom	token	The value in any kind of contact	Practitioner.telecom, Practitioner.role.telecom	4 Resources