Encounters represent a patient visit or consultation. Each time a patient record is created for a patient there will be corresponding encounter. Encounters are assigned to a patient and may be searched. A search request (GET) for patient encounters returns a bundle of one or more FHIR items of type KBV_PR_AW_Begegnung.

{{baseURL}}/{{tenant}}/Encounter?page=1&subject=Patient/6009

Example: this search requests fetches all encounters of patient 6009 using paging to limit the number of results.

For an example see RED Interchange API - Postman Collection 0104 - Patient - All Encounters (Begebnungen)


A request for Encounters may be extended with a date range.  If date range is given RED will return encounters only if their from and/or to dates will match the given date range. The number of coverages to be returned for one request is limited, so paging should be used.

{{baseURL}}/{{tenant}}/Encounter?page=1&subject=Patient/6020&from=20230101&to=20230630

For an example see RED Interchange API - Postman Collection 0105 - Patient - Encounters in date range


Giving only one parameter will return all coverages matching the daterange (e.g. from date of 01.01.2023 will return coverages from first quarter of 2023 until today) 

{{baseURL}}/{{tenant}}/Encounter?page=1&subject=Patient/6020&from=20230331

For an example see RED Interchange API - Postman Collection 0106 - Patient - Encounters from date


<Encounter xmlns="http://hl7.org/fhir">
                <id value="TTwnq1kqRk8v5uwmL7BkyOAHfDJmYbiz"/>
                <meta>
                    <versionId value="1"/>
                    <lastUpdated value="2022-07-03T09:37:50+00:00"/>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Begegnung|1.2.0"/>
                </meta>
                <text>
                    <status value="extensions"/>
                    <div xmlns="http://www.w3.org/1999/xhtml">Begegnung vom 02.07.2022 bis 02.07.2022 (V1) | ID TTwnq1kqRk8v5uwmL7BkyOAHfDJmYbiz | Status beendet | Klassifizierung ambulante Behandlung | Patient Dirk Wulf | Behandlerkontext LANR 362364901/BSNR 478818100 Dr. med. Annie More (1) | Organisation Betriebsstätte RED Medical Systems | zuletzt bearbeitet 2022-07-03T09:37:50+00:00</div>
                </text>
                <status value="finished"/>
                <class>
                    <system value="http://terminology.hl7.org/CodeSystem/v3-ActCode"/>
                    <code value="AMB"/>
                </class>
                <subject>
                    <reference value="Patient/W4BYbPJsGvWA2sGEfQd9rLv7FFnDeXbh/_history/1"/>
                </subject>
                <participant>
                    <individual>
                        <reference value="PractitionerRole/TcYtTcJHpzXbgAoEAG091FE05w0ZhrXn/_history/1"/>
                    </individual>
                </participant>
                <period>
                    <start value="2022-07-02"/>
                    <end value="2022-07-02"/>
                </period>
                <serviceProvider>
                    <reference value="Organization/yYJ1iAwyEocr1h2HJM0HWzGeWJMcjJrM/_history/1"/>
                </serviceProvider>
            </Encounter>