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.

For an example see RED Interchange API - Postman Collection 0020 - All Practitioners.

SEARCH request for 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.


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

READ request for a specific practitioner
{{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.


Example of a FHIR item practitioner
<Practitioner xmlns="http://hl7.org/fhir">
    <id value="wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB"/>
    <meta>
        <versionId value="1"/>
        <lastUpdated value="2022-06-27T18:54:31+00:00"/>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Behandelnder|1.2.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 | E-Mail aw@redmedical.de | zuletzt bearbeitet 2022-06-27T18:54:31+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>
    <telecom>
        <system value="email"/>
        <value value="annie.more@redmedical.de"/>
    </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="female"/>
    <qualification>
        <code>
            <coding>
                <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_ARZTNRFACHGRUPPE"/>
                <code value="01"/>
            </coding>
        </code>
    </qualification>
</Practitioner>

The relation between physician (practitioner) and practice is defined by practitionerRoles → RED interchange API - Search/Read PractitionerRoles

  • No labels