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.


Data of a specific encounter may be fetched using a read request (GET) with the identifier of the specific encounter. The request returns a FHIR item of type KBV_PR_AW_Begegnung.

{{baseURL}}/{{tenant}}/Encounter/TTwnq1kqRk8v5uwmL7BkyOAHfDJmYbiz

Example: this read request returns the FHIR item for encounter with ID TTwnq1kqRk8v5uwmL7BkyOAHfDJmYbiz. The ID may be retrieved by a search request sent before this request.


<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>