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
Patient Administration Work Group | Maturity Level: 1 | Compartments: Practitioner |
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 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.
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
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 | |
practitionerRole | 0..* | BackboneElement | Roles/organizations the practitioner is associated with | |
organization | 0..1 | Reference(Organization) | Organization where the roles are performed | |
role | Σ | 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) | |
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 Language (Required) | |
Documentation for this format |
UML Diagram
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> <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
{ "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 | 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 | |
practitionerRole | 0..* | BackboneElement | Roles/organizations the practitioner is associated with | |
organization | 0..1 | Reference(Organization) | Organization where the roles are performed | |
role | Σ | 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) | |
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 Language (Required) | |
Documentation for this format |
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> <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
{ "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
Path | Definition | Type | Reference |
---|---|---|---|
Practitioner.gender | The gender of a person used for administrative purposes. | Required | AdministrativeGender |
Practitioner.practitionerRole.role | The role a person plays representing an organization | Example | PractitionerRole |
Practitioner.practitionerRole.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. | Required | IETF language tag |
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 |
address | string | An address in any kind of address/part | 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 | One of the languages that the practitioner can communicate with | Practitioner.communication |
token | A value in an email contact | Practitioner.telecom(system=email), Practitioner.practitionerRole.telecom(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.practitionerRole.identifier |
location | reference | One of the locations at which this practitioner provides care | Practitioner.practitionerRole.location (Location) |
name | string | A portion of either family or given name | Practitioner.name |
organization | reference | The identity of the organization the practitioner represents / acts on behalf of | Practitioner.practitionerRole.organization (Organization) |
phone | token | A value in a phone contact | Practitioner.telecom(system=phone), Practitioner.practitionerRole.telecom(system=phone) |
phonetic | string | A portion of either family or given name using some kind of phonetic matching algorithm | Practitioner.name |
role | token | The practitioner can perform this role at for the organization | Practitioner.practitionerRole.role |
specialty | token | The practitioner has this specialty at an organization | Practitioner.practitionerRole.specialty |
telecom | token | The value in any kind of contact | Practitioner.telecom, Practitioner.practitionerRole.telecom |