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:
    • specialty: The specialty of the practitioner role to search for.
      Specialties are defined by Vektis in the Zorgverlenersspecificatie (subberoepsgroep) (system urn:oid:2.16.840.1.113883.2.4.6.7).
    • 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.