Standardized Medication Profile (SMP) FHIR IG, published by HL7 International / Pharmacy. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/smp-ig/ and changes regularly. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
| smp-client |
This resource defines the expected capabilities of the SMP Server actor when conforming to the SMP IG and It is expected that it will be used in conjunction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles and RESTful operations supported by SMP clients. SMP Client requirements may also be impacted by the rules of local jurisdictions or other contextual requirements. |
| smp-server |
This resource defines the expected capabilities of the SMP Server actor when conforming to the SMP IG and It is expected that it will be used in conjunction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles and RESTful operations supported by SMP servers. SMP Server requirements may also be impacted by the rules of local jurisdictions or other contextual requirements. |
These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.
| SMP Operation Retrieve |
Optional operation to request an individual patient's medication history |
| SMP Operation Submit |
Optional operation to submit an individual patient's medication history list for storage |
These define constraints on FHIR resources for systems conforming to this implementation guide.
| SMP Composition Medication Action Plan |
A composition resource that defines the metadata for a medication action plan document. |
| SMP Parameters - Outcome |
This profile tailors the Parameters resource to convey status result of request to store medication history. |
| SMP Parameters - Query |
This profile tailors the Parameters resource to convey medication History operation inputs. |
| SMP Parameters - Response |
This profile tailors the Parameters resource to convey medication History operation outputs. |
| SMP Parameters - Submit |
This profile tailors the Parameters resource to convey medication History operation inputs for storage. |
| Standardized Medication Profile - Bundle Medication Action Plan |
A single package that contains a collection of medication action plans and supporting metadata on the medication reconciliaton review and recommended actions. |
| Standardized Medication Profile - Bundle Medication List |
A single package that contains a specific kind of medication list with all supporting MedicationStatements and possibly other supporting resources. |
| Standardized Medication Profile - Bundle Medication List Maintenance |
A way to define and create a specific kind of medication list and the various medications that are on the list in a single transaction. |
| Standardized Medication Profile - Medication |
A description of a patient medication, may be used for non-prescription medications. Contains specifics about the type and strength that can be used to inform medication reconciliation. |
| Standardized Medication Profile - Medication Action Plan |
A pharmacist-generated care plan that identifies issues and risks as well as recommended interventions and actions. These plans are normally created in response to a comprehensive medication review. |
| Standardized Medication Profile - Medication Action Plan Detected Issue |
An issues or risk related to a given medication, therapy, or regimen. May include interventions and actions that mitigate the issue. |
| Standardized Medication Profile - Medication List |
A related set of descriptions of individual medications a patient is or has received. May be a currently being administered list, a list of medications for discharge or a list of discontinued medications (with reasons). The list is point in time. |
| Standardized Medication Profile - MedicationAdministration |
Defines the actual giving of a drug or compound to a patient for the purposes of treatment. |
| Standardized Medication Profile - MedicationStatement |
The description of a medication or drug that a patient is taking or prescribed. Or a medication or drug that a patient did take or was prescribed in the past. MedicationStatement can be created from a number of sources and may be anecdotal which can be useful in the recording of non-prescription, over-the-counter items. MedicationRequest and MedicationAdministration are a formal record of medications prescribed and given. This profile supports the capture of medication adherence information within the MedicationStatement resource. Implementers SHOULD pre-adopt the FHIR MedicationStatement adherence extension as proposed for future FHIR releases.
|
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
| ActualMeds-DocumentReference-PatientSummary20260107105203 | |
| Clopidogrel Bisulfate Oral Tablet 75 MG,Sertraline HCl Oral Tablet 25 MG Betsy Smith-Johnson Med Action Plan (MAP) |
Change medication dose Betsy Smith-Johnson Med Action Plan (MAP) |
| Example Alprazolam Medication Request |
A medication request for alprazolam 0.5 MG Oral Tablet |
| Example Med Action Plan (MAP) - Alprazolam and metoclopramide concurrent therapy as detected issue |
Example Med Action Plan (MAP) - Alprazolam and metoclopramide concurrent therapy as DetectedIssue with risk for falls. |
| Example Metoclopramide Medication Request |
A medication request for metoclopramide 10 MG Oral Tablet |
| Example Patient |
A sample US Core patient |
| Example Practitioner - Pharmacist |
A sample practitioner |
| Example Practitioner - Primary Care Physician |
A sample US Core practitioner |
| Example-DocumentReference-PatientSummary20250709093054 | |
| Hospital Medication Administration List |
Example of a List resource for a patient's SMP list |
| Jardiance Oral Tablet 10 MG,metFORMIN HCl Oral Tablet 500 MG,Sertraline HCl Oral Tablet 25 MG Betsy Smith-Johnson Med Action Plan (MAP) |
Medication Action Plan Detected Issue Example - betsysmith-johnson01-MAP-Drug-druginteraction1 |
| Practitioner-AnitaChu |
Anita Chu's practitioner record. |
| Practitioner-KevinJames | |
| Practitioner-PriyaSarkar |
Priya Sarkar's practitioner record. |
| PractitionerRole-Physician-PriyaSarkar |
Priya Sarkar's role at the Metro Hospital Emergency Department |
| Primary Care Medication List |
Example of a List resource for a patient's SMP primary care medication list |
| Role-IMMD-AnitaChu |
Dr. Anita M. Chu's role at Michigan Primary Health Care Associates. |
| SMP Medication Action Plan for betsysmith-johnson01 |
Medication Action Plan Composition Example |
| SMP Medication Action Plan for examplePatient |
Example of a SMP Medication Action Plan Composition |
| betsysmith-johnson01-di01-Drug-druginteraction0 | |
| betsysmith-johnson01-di01-Drug-druginteraction1 |
Medication Action Plan Detected Issue Example - betsysmith-johnson01-di01-Drug-druginteraction1 |
| bsj1-smp-medrx-clopidogrel-1-11 |
MedicationRequest for clopidogrel - active order on 2025-05-04 by PractitionerRole-Physician-PriyaSarkar |
| bsj1-smp-medrx-jardiance-1-5 |
MedicationRequest for jardiance - draft order on 2025-05-03 by PractitionerRole-Physician-PriyaSarkar |
| bsj1-smp-medrx-metformin-0-12 |
MedicationRequest for metformin - active order on 2025-04-22 by Role-IMMD-AnitaChu |
| bsj1-smp-medrx-sertraline-1-8 |
MedicationRequest for sertraline - active order on 2025-05-03 by PractitionerRole-Physician-PriyaSarkar |
| bsj1-smp-medstmt-clopidogrel-1-11 | |
| bsj1-smp-medstmt-jardiance-1-5 | |
| bsj1-smp-medstmt-metformin-0-12 | |
| bsj1-smp-medstmt-sertraline-1-8 | |
| ddca07f5-6e40-4c30-952e-23cffd48b045 | |
| example-MedicationStatement-alprazolam-01 |
Example Alprazolam Medication Statement |
| example-MedicationStatement-metoclopramide-01 |
Example Metoclopramide Medication Statement |
| example-di01-duplicateTherapy | |
| org-ED-Metro-Hospital |
Metro Hospital Emergency Department organization. |
| org-Loc-Michigan-Primary-Health-Care-A |
Michigan Primary Health Care Associates Example |
| org-Michigan-Primary-Health-Care-A |
Michigan Primary Health Care Associates organization. |
| org-PC-Primary-Care-Michigan |
Michigan Primary Health Care Associates's organization record. |
| patient-betsysmith-johnson01 | |
| smp-bundle-1 |
Example of a Bundle resource used to transmit a patient's SMP medication list and contents |
| smp-bundle-tx-1 |
Example of a Bundle resource used to create a medication list with a single entry |
| smp-bundle-tx-2 |
Example of a Bundle resource used to create multiple medication lists (hospital admission and discharge lists) in a single transaction |
| smp-history-input-parameters-1 |
Example of a Parameters resource used to request a patient's medication history |
| smp-history-output-parameters-1 |
Example of a Parameters resource used to respond to a request a patient's medication history |
| smp-med-1 |
Example of a Medication resource in a patient's SMP list |
| smp-medadm-1 |
Example of a MedicationAdministration resource for a patient's SMP list |
| smp-medication-action-plan-bundle-example01 | |
| smp-medstmt-1 |
Example of a MedicationStatement resource in a patient's SMP list |
| smp-medstmt-2 |
Example of a MedicationStatement resource in a patient's SMP list with a reference to a MedicationAdministration |
| smp-medstmt-3 |
Example of a MedicationStatement resource in a patient's SMP list for Amlodipine |
| smp-medstmt-4 |
Example of a MedicationStatement that uses effectivePeriod instead of effectiveDateTime |
| smp-submit-input-parameters-1 |
Example of a Parameters resource used to submit a patient's medication history |
| smp-submit-outcome-parameters-1 |
Example of a Parameters resource used to respond to a submission of a patient's medication history |