ERA FHIR specification
1.0.0 - draft
ERA FHIR specification - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://eradocumentation.atostek.com/OperationDefinition/MedicationListFi-get-history-medications | Version: 1.0.0 | |||
| Draft as of 2026-10-28 | Computable Name: MedicationListFi-Get-History-Medications | |||
The operation makes a request to the Kanta Prescription Centre and retrieves the complete history of the selected medications. This includes information about prescriptions, discontinuation notes, and dispenses. The search is patient-specific.
The operation requires an active ERA session and the client registry ID. Please provide these in the request header.
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.
URL: [base]/$MedicationListFi-get-history-medications
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | requestPurpose | 1..1 | Coding | 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. | ||
| IN | serviceEventId | 0..1 | Identifier | Identifier of a service event, if request is done from a open service event. | ||
| IN | medicineId | 1..* | Identifier | Identifier of the medication currently in use. A maximum of 50 identifiers can be provided. | ||
| IN | authoredOn | 1..1 | Period | 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. An exception to this are pharmacies and hospital pharmacies, for which the search is limited to 42 months prior to the current time point. The accepted date format is YYYY-MM-DD. | ||
| IN | latestDispenseOnly | 1..1 | boolean | Return only the latest dispense of a medication (true) or all dispenses (false). In both cases, only the most recent version of the dispense is returned. | ||
| IN | x-extent | 0..1 | Coding | Return only up-to-date versions (code: "1") or all versions (code: "2"). The Kanta code system 'urn:oid:1.2.246.537.5.40160.2008' (KanTa-palvelut - Palautettavien tietojen kattavuus) needs to be specified. | ||
| OUT | return | 1..1 | Bundle | Medication history |