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>
