Huli FHIR Core Implementation Guide (R4) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

PractitionerRole Mapping

PractitionerRole Mapping: Huli -> FHIR R4

PractitionerRole wires a practitioner to the locations where they practice and the specialties they deliver, sourced from the Huli practitioner ↔ location ↔ specialty assignments. It is read-only on the Public API; assignments are managed through the operator-facing platform.

PractitionerRole is a discovery resource that lets booking clients resolve "which practitioner is bookable, where, for what". Access is gated by the practitioner scope system/Practitioner.rs (see Terminology).

Interactions

Interaction	Supported
read	Yes
search-type	Yes
vread	No
update	No
patch	No
delete	No
history	No
create	No

Read by id via GET /fhir/R4/PractitionerRole/{id}; list via GET /fhir/R4/PractitionerRole (offset pagination).

Mapping

Huli concept	FHIR path	Cardinality	Notes
Role id (UUID)	PractitionerRole.id	1..1	UUID of the practitioner-role assignment
Last update	PractitionerRole.meta.lastUpdated	0..1	Set by the platform
Active status	PractitionerRole.active	0..1	true for live assignments
Practitioner	PractitionerRole.practitioner	1..1	Reference to Practitioner/{id}
Location(s)	PractitionerRole.location	0..*	Reference(s) to Location/{id} where the practitioner works
Specialty	PractitionerRole.specialty	0..*	The clinical specialty delivered in this role

Search parameters

Parameter	Type	Notes
_id	token	Exact id match
practitioner	reference	Filter by Practitioner/{id}
location	reference	Filter by Location/{id}
_count	number	Page size
_offset	number	Offset pagination