Implementation Guide
ePA Medication Service
Version 1.2.0-ballot.2 - draft

## : Get Medication List - XML Representation

Draft as of 2025-09-02

Raw xml | Download

    <OperationDefinition xmlns="http://hl7.org/fhir">
      <id value="get-medication-list-op"/>
      <meta>
        <profile
                 value="https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition"/>
      </meta>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition get-medication-list-op</b></p><a name="get-medication-list-op"> </a><a name="hcget-medication-list-op"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="https://gematik.de/fhir/ti/1.1.1-ballot.1/StructureDefinition-ti-operationdefinition.html">OperationDefinition Profil für TI FHIR Data Service</a></p></div><p>URL: [base]/$$medication-list</p><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>date</td><td/><td>0..2</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a><br/>(<a href="https://hl7.org/fhir/R4/search.html#date">date</a>)</td><td/><td><div><p>Limit the search to this date. Can specify upper or lower limits and periods by providing an upper and a lower limit.</p>
    </div></td></tr><tr><td>IN</td><td>_count</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a><br/>(<a href="https://hl7.org/fhir/R4/search.html#number">number</a>)</td><td/><td><div><p>Limit the result bundle to this many entries. To get more entries request the next page.</p>
    </div></td></tr><tr><td>IN</td><td>_offset</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a><br/>(<a href="https://hl7.org/fhir/R4/search.html#number">number</a>)</td><td/><td><div><p>Defines the offset of the first entry in the collection.</p>
    </div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>Searchset bundle containing the requested entities.</p>
    </div></td></tr></table></div>
      </text>
      <extension
                 url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-method">
        <valueCode value="GET"/>
      </extension>
      <url
           value="https://gematik.de/fhir/epa-medication/OperationDefinition/get-medication-list-op"/>
      <version value="1.2.0-ballot.2"/>
      <name value="getMedicationList_MedicationSvc"/>
      <title value="Get Medication List"/>
      <status value="draft"/>
      <kind value="operation"/>
      <date value="2025-09-02"/>
      <publisher value="gematik GmbH"/>
      <contact>
        <name value="gematik GmbH"/>
        <telecom>
          <system value="url"/>
          <value value="https://www.gematik.de"/>
        </telecom>
        <telecom>
          <system value="email"/>
          <value value="patientteam [ at ] gematik.de"/>
        </telecom>
      </contact>
      <description
                   value="Die Operation liefert die elektronische Medikationsliste (eML) in Form eines FHIR searchSet-Bundles. In der eML werden ausschließlich nicht stornierte Instanzen von Verschreibungsdaten, Dispensierdaten, nachgetragenen Medikamenten sowie die zugehörige Versicherteninformation aus dem Patient Service angezeigt."/>
      <jurisdiction>
        <coding>
          <system value="urn:iso:std:iso:3166"/>
          <code value="DE"/>
        </coding>
      </jurisdiction>
      <affectsState value="false"/>
      <code value="medication-list"/>
      <system value="true"/>
      <type value="false"/>
      <instance value="false"/>
      <parameter>
        <name value="date"/>
        <use value="in"/>
        <min value="0"/>
        <max value="2"/>
        <documentation
                       value="Limit the search to this date. Can specify upper or lower limits and periods by providing an upper and a lower limit."/>
        <type value="string"/>
        <searchType value="date"/>
      </parameter>
      <parameter>
        <name value="_count"/>
        <use value="in"/>
        <min value="0"/>
        <max value="1"/>
        <documentation
                       value="Limit the result bundle to this many entries. To get more entries request the next page."/>
        <type value="string"/>
        <searchType value="number"/>
      </parameter>
      <parameter>
        <name value="_offset"/>
        <use value="in"/>
        <min value="0"/>
        <max value="1"/>
        <documentation
                       value="Defines the offset of the first entry in the collection."/>
        <type value="string"/>
        <searchType value="number"/>
      </parameter>
      <parameter>
        <name value="return"/>
        <use value="out"/>
        <min value="1"/>
        <max value="1"/>
        <documentation
                       value="Searchset bundle containing the requested entities."/>
        <type value="Bundle"/>
      </parameter>
    </OperationDefinition>