Practitioners are the physicians defined in RED as users/user LANRs. Practitioners contain names and identifiers for physicians. Practitioners can be searched using a search request (GET). Search returns a bundle of one or more FHIR items of type KBV_PR_AW_Behandelnder. The relation between physician (practitioner) and practice is defined by practitionerRoles → RED interchange API - Search/Read PractitionerRoles
For an example see RED Interchange API - Postman Collection 0020 - All Practitioners.
{{baseURL}}/{{tenant}}/Practitioner?page=1
Example: this search requests fetches all practitioners defined in RED using paging to limit the number of results.
<Bundle xmlns="http://hl7.org/fhir">
<id value="dbff52e9-2029-3847-ad78-acec1ddb1f66"/>
<meta>
<lastUpdated value="2024-08-01T14:00:19+00:00"/>
</meta>
<type value="searchset"/>
<total value="47"/>
<self>
<relation value="self"/>
<url value="/alexanderwilms_7788/Practitioner?page=1"/>
</self>
<first>
<relation value="first"/>
<url value="/alexanderwilms_7788/Practitioner?page=1"/>
</first>
<next>
<relation value="next"/>
<url value="/alexanderwilms_7788/Practitioner?page=2"/>
</next>
<last>
<relation value="last"/>
<url value="/alexanderwilms_7788/Practitioner?page=5"/>
</last>
<entry>
<fullUrl value="/Practitioner/wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB"/>
<resource>
<Practitioner xmlns="http://hl7.org/fhir">
<id value="wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB"/>
<meta>
<versionId value="1"/>
<lastUpdated value="2024-08-01T14:00:19+00:00"/>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Behandelnder|1.3.0"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml">Behandler Dr. med. Annie More (V1) | ID wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB | Geschlecht unbekannt | Qualifikation Allgemeinmedizin | LANR 362364901 | Adresse Hauptstrasse 180, 56170 Bendorf | Telefon 0171 1014211 | zuletzt bearbeitet 2024-08-01T14:00:19+00:00</div>
</text>
<identifier>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/v2-0203"/>
<code value="LANR"/>
</coding>
</type>
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR"/>
<value value="362364901"/>
</identifier>
<name>
<use value="official"/>
<text value="Dr. med. Annie More"/>
<family value="More">
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
<valueString value="More"/>
</extension>
</family>
<given value="Annie"/>
<prefix value="Dr. med.">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="AC"/>
</extension>
</prefix>
</name>
<telecom>
<system value="phone"/>
<value value="01711014211"/>
</telecom>
<telecom>
<system value="fax"/>
<value value="0643144672"/>
</telecom>
<address>
<type value="both"/>
<line value="Hauptstrasse 180">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
<valueString value="Hauptstrasse"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
<valueString value="180"/>
</extension>
</line>
<city value="Bendorf"/>
<postalCode value="56170"/>
<country value="D"/>
</address>
<gender value="unknown"/>
<qualification>
<code>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_ARZTNRFACHGRUPPE"/>
<code value="01"/>
</coding>
</code>
</qualification>
</Practitioner>
</resource>
</entry>
// ... more entries
</Bundle>
Data of a specific practitioner may be fetched using a read request (GET) with the identifier of the specific practitioner. The request returns a FHIR item of type KBV_PR_AW_Behandelnder
{{baseURL}}/{{tenant}}/Practitioner/wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB
Example: this read request returns the FHIR item for practitionier with ID wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB. The ID may be retrieved by a search request sent before this request.
For an example see RED Interchange API - Postman Collection 0021 - Specific Practitioner.
<Practitioner xmlns="http://hl7.org/fhir">
<id value="wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB"/>
<meta>
<versionId value="1"/>
<lastUpdated value="2024-08-01T13:58:56+00:00"/>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Behandelnder|1.3.0"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml">Behandler Dr. med. Annie More (V1) | ID wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB | Geschlecht unbekannt | Qualifikation Allgemeinmedizin | LANR 362364901 | Adresse Hauptstrasse 180, 56170 Bendorf | Telefon 0171 1014211 | zuletzt bearbeitet 2024-08-01T13:58:56+00:00</div>
</text>
<identifier>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/v2-0203"/>
<code value="LANR"/>
</coding>
</type>
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR"/>
<value value="362364901"/>
</identifier>
<name>
<use value="official"/>
<text value="Dr. med. Annie More"/>
<family value="More">
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
<valueString value="More"/>
</extension>
</family>
<given value="Annie"/>
<prefix value="Dr. med.">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="AC"/>
</extension>
</prefix>
</name>
<telecom>
<system value="phone"/>
<value value="01711014211"/>
</telecom>
<telecom>
<system value="fax"/>
<value value="0643144672"/>
</telecom>
<address>
<type value="both"/>
<line value="Hauptstrasse 180">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
<valueString value="Hauptstrasse"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
<valueString value="180"/>
</extension>
</line>
<city value="Bendorf"/>
<postalCode value="56170"/>
<country value="D"/>
</address>
<gender value="unknown"/>
<qualification>
<code>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_ARZTNRFACHGRUPPE"/>
<code value="01"/>
</coding>
</code>
</qualification>
</Practitioner>
