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 CapabilityStatement defines the expected capabilities of the SMP Client actor when conforming to the SMP Implementation Guide (IG). It is intended to be used together with the US Core CapabilityStatement. Combined, they describe the complete set of profiles and RESTful operations that SMP clients support. Client requirements may also be influenced by local jurisdictional rules and other contextual considerations.

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 Medication Action Plan is a pharmacist-evaluation of a patient’s medications, and other clinical factors (e.g.: conditions, allergies). It identifies potential drug therapy related issues, recommended interventions and medication list.

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 DocumentReference

A US Core DocumentReference constrained for references to SMP collection bundles by fixing the document type to LOINC 70006-2 Medication Management Note and limiting the subject to a US Core Patient.

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.

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

Primary Care Medication List

Example of a List resource for a patient's SMP primary care medication list

SMP Medication Action Plan for examplePatient

Example of a SMP Medication Action Plan Composition

example-MedicationStatement-alprazolam-01

Example Alprazolam Medication Statement

example-MedicationStatement-metoclopramide-01

Example Metoclopramide Medication Statement

example-di01-duplicateTherapy
smp-bundle-1

Example of a Bundle resource used to transmit a patient's SMP medication list and contents

smp-bundle-documentreference-example

Example DocumentReference for an SMP medication collection bundle.

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