PractitionerRoles combine physicians and their practices defined in RED. PractitionerRoles contain a reference to practitioners and organizations. PractitionerRoles can be searched using a search request (GET)  Search returns a bundle of one or more FHIR items of type KBV_PR_AW_Behandelnder.

SEARCH request for all practitioner roles
{{baseURL}}/{{tenant}}/PractitioneRole?page=1

Example: this search requests fetches all practitionerRoles defined in RED using paging to limit the number of results.


Data of a specific practitionerRole may be fetched using a read request (GET) with the identifier of the specific practitionerRole. The request returns a FHIR item of type KBV_PR_AW_BehandelnderFunktion

READ request for a specific practitionerRole
{{baseURL}}/{{tenant}}/PractitionerRole/TcYtTcJHpzXbgAoEAG091FE05w0ZhrXn

Example: this read request returns the FHIR item for practitionerRole with ID TcYtTcJHpzXbgAoEAG091FE05w0ZhrXn. The ID may be retrieved by a search request sent before this request.


Example of a FHIR item practitioner role
<PractitionerRole xmlns="http://hl7.org/fhir">
    <id value="TcYtTcJHpzXbgAoEAG091FE05w0ZhrXn"/>
    <meta>
        <versionId value="1"/>
        <lastUpdated value="2022-08-02T10:14:38+00:00"/>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_BehandelnderFunktion|1.2.0"/>
    </meta>
    <text>
        <status value="extensions"/>
        <div xmlns="http://www.w3.org/1999/xhtml">Behandlerrolle Dr. med. Annie More (V1) | ID TcYtTcJHpzXbgAoEAG091FE05w0ZhrXn | LANR 362364901 | Behandler Dr. med. Annie More | BSNR 478818100 | zuletzt bearbeitet 2022-08-02T10:14:38+00:00</div>
    </text>
    <practitioner>
        <reference value="Practitioner/wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB/_history/1"/>
    </practitioner>
    <organization>
        <reference value="Organization/yYJ1iAwyEocr1h2HJM0HWzGeWJMcjJrM/_history/1"/>
    </organization>
</PractitionerRole>

All practitionerRoles for a specific practitioner may be fetched using a read request with practitioner identifier.

READ request for all practitionerRoles of a specific practitioner
{{baseURL}}/{{tenant}}/PractitionerRole?practitioner=wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB

Example: this read request returns an array of all practitionerRoles for practitionier with ID wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB. The ID may be retrieved by a search request sent before this request.

  • No labels