Skip to main content

Practitioner(Role)

Data regarding practitioners can be retrieved through two FHIR endpoints: Practitioner and PractitionerRole.

Practitioner​

The Practitioner resource contains information about a practitioner, such as their name, contact information, and qualifications. Practitioners can only be retrieved by ID, or by being included in a PractitionerRole search.

GET <TENANT_BASE_URL>/fhir/Practitioner/<PRACTITIONER_ID>

PractitionerRole​

The PractitionerRole resource contains information about a practitioner's role at the organization it is associated with. It is the primary way to retrieve available care professionals for a given organization.

The two types of requests available are:

  • GET <TENANT_BASE_URL>/fhir/R4/PractitionerRole/<PRACTITIONER_ROLE_ID>
    Retrieves a single practitioner role by ID.
  • GET <TENANT_BASE_URL>/fhir/R4/PractitionerRole
    Search for practitioner roles.
    Available filters are:
    • identifier: Used to search for practitioners by their AGB code (system http://fhir.nl/fhir/NamingSystem/agb-z).
    • _include: Used to include the Practitioner resource in the response, should only ever have value PractitionerRole:practitioner.
note

Filtering by specialty is not yet implemented. Only identifier (AGB-Z code) filtering is currently supported for PractitionerRole search.