Generated Narrative: OperationDefinition MedicationListFi-get-medication-custom-data-by-author

URL: [base]/$MedicationListFi-get-medication-custom-data

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INrequestPurpose1..1Coding

Purpose of requesting medication information. Expressed using a code from the Kanta code system 'urn:oid:1.2.246.537.5.40110.2006' (Sähköinen lääkemääräys - Reseptikyselyn syy). Provide both the system and the code.

INserviceEventId0..1Identifier

Identifier of a service event, if request is done from a open service event.

INpatientIdentifier1..1Identifier

Identifier of the patient. Provide both the system 'urn:oid:1.2.246.21' and the value (the actual patient id).

INassignAuthorId1..1Identifier

Identifier of the author (Doctor ID, previously known as health insurance number or SV number).

INauthoredOn0..1Period

Time period for which medication history is requested. The length of the time period can be at most 36 months, but the period can be at any point in the patient's medication history. If the parameter is not provided, the default search period is 36 months before the current time point. The accepted date format is YYYY-MM-DD.

INlatestDispenseOnly0..1boolean

Return only the latest dispense of a prescription (true) or all dispenses (false). In both cases, only the most recent version of the dispense is returned. By default, only the latest dispenses are returned.

OUTreturn1..1Bundle

Kanta medication list

 <status value="draft"/> <kind value="operation"/> <date value="2026-10-28T11:52:12+00:00"/> <publisher value="Atostek"/> <contact> <name value="Atostek"/> <telecom> <system value="url"/> <value value="https://atostek.com/"/> </telecom> </contact> <description value="The search returns information about prescriptions that are prescribed by the author and the dispensations, renewal requests, blocks, reservations, and discontinuation notes of these prescriptions. Any restrictions set by the patient for sharing their personal health information don't affect this search. The search result is stored in the client's registry in ERA's database and returned to the client. If the search is performed successfully but returns no results, an empty Bundle is returned."/> <code value="MedicationListFi-get-medication-custom-data"/> <system value="true"/> <type value="false"/> <instance value="false"/> <parameter> <name value="requestPurpose"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="Purpose of requesting medication information. Expressed using a code from the Kanta code system 'urn:oid:1.2.246.537.5.40110.2006' (Sähköinen lääkemääräys - Reseptikyselyn syy). Provide both the system and the code."/> <type value="Coding"/> </parameter> <parameter> <name value="serviceEventId"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Identifier of a service event, if request is done from a open service event."/> <type value="Identifier"/> </parameter> <parameter> <name value="patientIdentifier"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="Identifier of the patient. Provide both the system 'urn:oid:1.2.246.21' and the value (the actual patient id)."/> <type value="Identifier"/> </parameter> <parameter> <name value="assignAuthorId"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="Identifier of the author (Doctor ID, previously known as health insurance number or SV number)."/> <type value="Identifier"/> </parameter> <parameter> <name value="authoredOn"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Time period for which medication history is requested. The length of the time period can be at most 36 months, but the period can be at any point in the patient's medication history. If the parameter is not provided, the default search period is 36 months before the current time point. The accepted date format is YYYY-MM-DD."/> <type value="Period"/> </parameter> <parameter> <name value="latestDispenseOnly"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Return only the latest dispense of a prescription (true) or all dispenses (false). In both cases, only the most recent version of the dispense is returned. By default, only the latest dispenses are returned."/> <type value="boolean"/> </parameter> <parameter> <name value="return"/> <use value="out"/> <min value="1"/> <max value="1"/> <documentation value="Kanta medication list"/> <type value="Bundle"/> </parameter> </OperationDefinition>