Scenario: Search the PractitionerRole Directory
Search FHIR R4 PractitionerRole resources with advertised reference, chain, specialty, include, and date parameters.
Authorization
Use an OAuth 2.0 access token issued by OCI Identity Domains with the DDFS resource scopes required for the request. Configure the client and obtain tokens by following Create an Integrated Application and DDFS Authentication Reference.
Search parameters
The R4 PractitionerRole search surface advertises practitioner and specialty, in addition to _id, _lastUpdated, _profile, _tag, _count, and _total. See GET /api/fhir/r4/PractitionerRole for the exact parameter definitions.
Search by practitioner
Use a direct reference, the :identifier modifier, or one of the two advertised chains:
GET {base}/api/fhir/r4/PractitionerRole?practitioner=Practitioner/{practitioner_id}
GET {base}/api/fhir/r4/PractitionerRole?practitioner:identifier={system}|{value}
GET {base}/api/fhir/r4/PractitionerRole?practitioner.identifier={system}|{value}
GET {base}/api/fhir/r4/PractitionerRole?practitioner.name={name}
The advertised practitioner chains are exactly identifier and name.
Search by specialty
Use one token value for the advertised specialty parameter:
GET {base}/api/fhir/r4/PractitionerRole?specialty={system}|{code}
Include referenced resources
The R4 PractitionerRole contract advertises exactly two include values:
PractitionerRole:practitionerPractitionerRole:endpoint
GET {base}/api/fhir/r4/PractitionerRole?practitioner=Practitioner/{practitioner_id}&_include=PractitionerRole:practitioner
GET {base}/api/fhir/r4/PractitionerRole?_id={role_id}&_include=PractitionerRole:endpoint
Search by last update
The _lastUpdated parameter accepts the advertised date comparators. A range can use a maximum of two repeated parameters. Do not combine date values with a comma.
GET {base}/api/fhir/r4/PractitionerRole?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
Use the advertised _count parameter when requesting a page size.