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.
For an example see RED Interchange API - Postman Collection 003 - All PractitionerRoles.
{{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
{{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.
For an example see RED Interchange API - Postman Collection 0031 - Specific PractitionerRole
PractitionerRoles may also be fetched for a given practitioner or organization ID, returning all practitionerRoles the practitioner or organization is referenced to.
{{baseURL}}/{{tenant}}/PractitionerRole?practitioner=Practitioner/wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB&page=1 |
Example: this read request returns the FHIR items for all practitionerRoles referenced to practitioner ID wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB.
For an example see RED Interchange API - Postman Collection 0032 - PractitionerRole for Practitioner-ID and 0033 - PractitionerRole for Organization-ID
<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.
{{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.