<?xml version="1.0" encoding="UTF-8"?>

<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="appointment-query-searchByEncounter"/>
  <text>
    <status value="generated"/><div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition appointment-query-searchByEncounter</b></p><a name="appointment-query-searchByEncounter"> </a><a name="hcappointment-query-searchByEncounter"> </a><a name="appointment-query-searchByEncounter-en-US"> </a><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>_query</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a><br/>(<a href="http://hl7.org/fhir/R4/search.html#string">string</a>)</td><td><a href="http://hl7.org/fhir/R4/valueset-binding-strength.html">BindingStrength</a> (Required)</td><td><div><p>Extended search parameter, value has to be searchByEncounter</p>
</div></td></tr><tr><td>IN</td><td>encounter</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a><br/>(<a href="http://hl7.org/fhir/R4/search.html#string">string</a>)</td><td><a href="http://hl7.org/fhir/R4/valueset-binding-strength.html">BindingStrength</a> (Required)</td><td><div><p>The encounter ID.</p>
</div></td></tr><tr><td>IN</td><td>date</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#date">date</a></td><td><a href="http://hl7.org/fhir/R4/valueset-binding-strength.html">BindingStrength</a> (Required)</td><td><div><p>Time window where appointments are taking place</p>
</div></td></tr><tr><td>IN</td><td>_lastUpdated</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#date">date</a></td><td><a href="http://hl7.org/fhir/R4/valueset-binding-strength.html">BindingStrength</a> (Required)</td><td><div><p>Time window in which the appointments were last updated</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td><a href="http://hl7.org/fhir/R4/valueset-binding-strength.html">BindingStrength</a> (Required)</td><td><div><p>A bundle of appointment ressources.</p>
</div></td></tr></table></div>
  </text>
  <url value="http://fhir.kisimdocs.ch/ig/KisimScheduling/OperationDefinition/appointment-query-searchByEncounter"/>
  <version value="1.0.3"/>
  <name value="SearchAppointmentByEncounter"/>
  <title value="Search Appointments by Encounter"/>
  <status value="draft"/>
  <kind value="query"/>
  <date value="2025-07-25T15:46:04+02:00"/>
  <publisher value="Cistec AG"/>
  <contact>
    <name value="Cistec AG"/>
    <telecom>
      <system value="url"/>
      <value value="https://www.cistec.com"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="robert.birri@cistec.com"/>
    </telecom>
  </contact>
  <description value="Search appointments for a specific encounter"/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="CH"/>
    </coding>
  </jurisdiction>
  <code value="searchByUser"/>
  <resource value="Appointment"/>
  <system value="false"/>
  <type value="false"/>
  <instance value="false"/>
  <parameter>
    <name value="_query"/>
    <use value="in"/>
    <min value="1"/>
    <max value="1"/>
    <documentation value="Extended search parameter, value has to be searchByEncounter"/>
    <type value="string"/>
    <searchType value="string"/>
    <binding>
      <strength value="required"/>
      <valueSet value="http://hl7.org/fhir/ValueSet/binding-strength"/>
    </binding>
  </parameter>
  <parameter>
    <name value="encounter"/>
    <use value="in"/>
    <min value="1"/>
    <max value="1"/>
    <documentation value="The encounter ID."/>
    <type value="string"/>
    <searchType value="string"/>
    <binding>
      <strength value="required"/>
      <valueSet value="http://hl7.org/fhir/ValueSet/binding-strength"/>
    </binding>
  </parameter>
  <parameter>
    <name value="date"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation value="Time window where appointments are taking place"/>
    <type value="date"/>
    <binding>
      <strength value="required"/>
      <valueSet value="http://hl7.org/fhir/ValueSet/binding-strength"/>
    </binding>
  </parameter>
  <parameter>
    <name value="_lastUpdated"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation value="Time window in which the appointments were last updated"/>
    <type value="date"/>
    <binding>
      <strength value="required"/>
      <valueSet value="http://hl7.org/fhir/ValueSet/binding-strength"/>
    </binding>
  </parameter>
  <parameter>
    <name value="return"/>
    <use value="out"/>
    <min value="0"/>
    <max value="1"/>
    <documentation value="A bundle of appointment ressources."/>
    <type value="Bundle"/>
    <binding>
      <strength value="required"/>
      <valueSet value="http://hl7.org/fhir/ValueSet/binding-strength"/>
    </binding>
  </parameter>
</OperationDefinition>