Organizations are practices defined in RED as user groups. Organizations contain e.g. addresses and contact information for a practice. Organizations can be searched using a search request (GET). Search for organizations will return a bundle including one or more FHIR items of type KBV_PR_AW_Betriebsstaette. 

For an example see RED Interchange API - Postman Collection example 004 All Organizations.

{{baseURL}}/{{tenant}}/Organization?page=1

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


Data of a specific organization may be fetched using a read request (GET) including the identifier of the specific organization. A read request returns one FHIR item of type KBV_PR_AW_Betriebsstaette. A read request for an organization specifies the organization by its organization ID. The organization ID may be fetched by a previous search request.

{{baseURL}}/{{tenant}}/Organization/wK7hhpbEIG1qkSdvRCCd3AEA3W4lBfDB

Example: this read request returns the FHIR item for organization 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 0040 - All Organizations


<Organization xmlns="http://hl7.org/fhir">
    <id value="JAVnINQ7OOy5dMkdorAuXSEJJCPT2PAw"/>
    <meta>
        <versionId value="1"/>
        <lastUpdated value="2022-08-04T09:44:06+00:00"/>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Betriebsstaette|1.2.0"/>
    </meta>
    <text>
        <status value="extensions"/>
        <div xmlns="http://www.w3.org/1999/xhtml">Organisation Dr. med. Hans Topp-Glücklich (V1) | ID JAVnINQ7OOy5dMkdorAuXSEJJCPT2PAwBSNR 391234511 | Adresse Musterstrasse 1, 64283 Darmstadt | Telefon 06151 / 1111111 | zuletzt bearbeitet 2022-08-04T09:44:06+00:00</div>
    </text>
    <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_AW_Betriebsstaette_Hierarchie">
        <valueCode value="BSNR"/>
    </extension>
    <identifier>
        <type>
            <coding>
                <system value="http://terminology.hl7.org/CodeSystem/v2-0203"/>
                <code value="BSNR"/>
            </coding>
        </type>
        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR"/>
        <value value="391234511"/>
    </identifier>
    <name value="Dr. med. Hans Topp-Glücklich"/>
    <telecom>
        <system value="phone"/>
        <value value="061511111111"/>
    </telecom>
    <telecom>
        <system value="fax"/>
        <value value="061512222222"/>
    </telecom>
    <address>
        <type value="both"/>
        <line value="Musterstrasse 1">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
                <valueString value="Musterstrasse"/>
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
                <valueString value="1"/>
            </extension>
        </line>
        <city value="Darmstadt"/>
        <postalCode value="64283"/>
        <country value="D"/>
    </address>
</Organization>