Standardized Medication Profile (SMP) FHIR IG
1.0.0 - STU 1 United States of America flag

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

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

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.

Behavior: Operation Definitions

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

Structures: Resource Profiles

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.

  • The adherence extension SHOULD be included in MedicationStatement resources when information about a patient's adherence to a medication regimen is available.
  • The extension enables documentation of adherence status (e.g., 'taking as prescribed', 'not taking as prescribed') and, where applicable, the reason for non-adherence.
  • Systems SHOULD support the extension to facilitate interoperability and the exchange of clinically significant adherence data.

Example: Example Instances

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