# US Core MedicationAdministration Profile - Health eData 1 Sandbox v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **US Core MedicationAdministration Profile**

## Resource Profile: US Core MedicationAdministration Profile 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationadministration | *Version*:0.1.0 | |
| Active as of 2026-05-13 | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 3 | *Computable Name*:USCoreMedicationAdministrationProfile |
| *Other Identifiers:*OID:2.16.840.1.113883.4.642.40.2.42.74 | | |

 
The US Core MedicationAdministration Profile inherits from the FHIR [MedicationAdministration](https://hl7.org/fhir/R4/medicationadministration.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) **Medication Administration Data Element of the Medications Data Class**. It sets minimum expectations for the MedicationAdministration resource to record, search, and fetch information about medications administered to a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption. 

**Example Usage Scenarios:**

The following are example usage scenarios for the US Core MedicationAdministration profile:

* Query for MedicationAdministration resources belonging to a Patient
* [Record or update] a Patient MedicationAdministration

### Mandatory and Must Support Data Elements

The following data elements must always be present ([Mandatory] definition) or must be supported if the data is present in the sending system ([Must Support] definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The [Formal Views] below provides the formal summary, definitions, and terminology requirements.

**Each MedicationAdministration Must Have:**

1. a status
1. a medication
1. a patient
1. when the medication was administered

**Each MedicationAdministration Must Support:**

1. who administered the medication
1. reference to the administration order
1. free text dosage instructions (e.g., SIG)
1. the route of administration
1. the dose and rate

### Profile Specific Implementation Guidance

This section provides detailed implementation guidance for the US Core Profile to support implementation and certification.

### Liquid Script to Generate StructureDefinition All Nice N Pretty Like

{% include structure-table.md sd=sd source="differential" show_must_support=true show_uscdi=true %}

## USCoreMedicationAdministrationProfile — US Core MedicationAdministration Profile

The US Core MedicationAdministration Profile inherits from the FHIR [MedicationAdministration](https://hl7.org/fhir/R4/medicationadministration.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) **Medication Administration Data Element of the Medications Data Class**. It sets minimum expectations for the MedicationAdministration resource to record, search, and fetch information about medications administered to a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

* **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationadministration`
* **Version:** 0.1.0
* **Status:** active
* **Kind:** resource
* **Type:** `MedicationAdministration`
* **Base Definition:** `http://hl7.org/fhir/StructureDefinition/MedicationAdministration`
* **Derivation:** constraint

### Elements (differential)

| | | | | | |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `MedicationAdministration` |   |   | 0..* |   | **Administration of medication to a patient**Describes the event of a patient consuming or otherwise being administered a medication. This may be as simple as swallowing a tablet or it may be a long running infusion. Related resources tie this event to the authorizing prescription, and the specific encounter between patient and health care practitioner. |
| ↳`status` | ✅ |   | 1..1 | `code` | **in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown**Will generally be set to show that the administration has been completed. For some long running administrations such as infusions, it is possible for an administration to be started but not completed or it may be paused while some other process is under way.**Binding:** `http://hl7.org/fhir/ValueSet/medication-admin-status\|4.0.1` (required) — A set of codes indicating the current status of a MedicationAdministration. |
| ↳`medication[x]` | ✅ |   | 1..1 | `CodeableConcept``Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-medication | **What was administered**Identifies the medication that was administered. This is either a link to a resource representing the details of the medication or a simple attribute carrying a code that identifies the medication from a known list of medications.**Binding:** `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4` (extensible) |
| ↳`subject` | ✅ |   | 1..1 | `Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patienttarget: http://hl7.org/fhir/StructureDefinition/Group | **Who received medication**The person or animal or group receiving the medication. |
| ↳`effective[x]` | ✅ |   | 1..1 | `dateTime``Period` | **Start and end time of administration**A specific date/time or interval of time during which the administration took place (or did not take place, when the 'notGiven' attribute is true). For many administrations, such as swallowing a tablet the use of dateTime is more appropriate. |
| ↳`performer` | ✅ |   | 0..* | `BackboneElement` | **Who performed the medication administration and what they did**Indicates who or what performed the medication administration and how they were involved. |
| ↳`actor` | ✅ |   | 1..1 | `Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionertarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patienttarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-organizationtarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerroletarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedpersontarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-device | **Who performed the medication administration**Indicates who or what performed the medication administration. |
| ↳`request` | ✅ |   | 0..1 | `Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest | **Request administration performed against**The original request, instruction or authority to perform the administration. |
| ↳`dosage` | ✅ |   | 0..1 | `BackboneElement` | **Details of how medication was taken**Describes the medication dosage information details e.g. dose, rate, site, route, etc. |
| ↳`text` | ✅ |   | 0..1 | `string` | **Free text dosage instructions e.g. SIG**Free text dosage can be used for cases where the dosage administered is too complex to code. When coded dosage is present, the free text dosage may still be present for display to humans. |

| | | | | | | |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| The dosage instructions should reflect the dosage of the medication that was administered. |   |   |   |   |   |   |
|   | ↳`route` | ✅ |   | 0..1 | `CodeableConcept` | **Path of substance into body**A code specifying the route or physiological path of administration of a therapeutic agent into or onto the patient. For example, topical, intravenous, etc.**Binding:** `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.22` (extensible) — SNOMED CT and NCI Thesaurus SPL route of administration codes |
|   | ↳`dose` | ✅ |   | 0..1 | `Quantity`profile: http://hl7.org/fhir/StructureDefinition/SimpleQuantity|4.0.1 | **Amount of medication per dose**The amount of the medication given at one administration event. Use this value when the administration is essentially an instantaneous event such as a swallowing a tablet or giving an injection.**Binding:** `http://hl7.org/fhir/ValueSet/ucum-common` (preferred) |

```


## USCoreMedicationAdministrationProfile — US Core MedicationAdministration Profile

The US Core MedicationAdministration Profile inherits from the FHIR [MedicationAdministration](https://hl7.org/fhir/R4/medicationadministration.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) *Medication Administration Data Element of the Medications Data Class*. It sets minimum expectations for the MedicationAdministration resource to record, search, and fetch information about medications administered to a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

- **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationadministration`
- **Version:** 0.1.0
- **Status:** active
- **Kind:** resource
- **Type:** `MedicationAdministration`
- **Base Definition:** `http://hl7.org/fhir/StructureDefinition/MedicationAdministration`
- **Derivation:** constraint


### Elements (differential)

| Element | Must Support | Add'l USCDI | Cardinality | Type | Description |
|---|:---:|:---:|---|---|---|
| `MedicationAdministration` |  |  | 0..* |  | **Administration of medication to a patient**<br/>Describes the event of a patient consuming or otherwise being administered a medication.  This may be as simple as swallowing a tablet or it may be a long running infusion.  Related resources tie this event to the authorizing prescription, and the specific encounter between patient and health care practitioner. |
| <span style="padding-left: 1.5em;">↳</span> `status` | ✅ |  | 1..1 | `code` | **in-progress \| not-done \| on-hold \| completed \| entered-in-error \| stopped \| unknown**<br/>Will generally be set to show that the administration has been completed.  For some long running administrations such as infusions, it is possible for an administration to be started but not completed or it may be paused while some other process is under way.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/medication-admin-status\|4.0.1` (required) — A set of codes indicating the current status of a MedicationAdministration.</span> |
| <span style="padding-left: 1.5em;">↳</span> `medication[x]` | ✅ |  | 1..1 | `CodeableConcept`<br/>`Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-medication</span> | **What was administered**<br/>Identifies the medication that was administered. This is either a link to a resource representing the details of the medication or a simple attribute carrying a code that identifies the medication from a known list of medications.<br/><span style="font-size: 0.85em;">**Binding:** `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4` (extensible)</span> |
| <span style="padding-left: 1.5em;">↳</span> `subject` | ✅ |  | 1..1 | `Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/StructureDefinition/Group</span> | **Who received medication**<br/>The person or animal or group receiving the medication. |
| <span style="padding-left: 1.5em;">↳</span> `effective[x]` | ✅ |  | 1..1 | `dateTime`<br/>`Period` | **Start and end time of administration**<br/>A specific date/time or interval of time during which the administration took place (or did not take place, when the 'notGiven' attribute is true). For many administrations, such as swallowing a tablet the use of dateTime is more appropriate. |
| <span style="padding-left: 1.5em;">↳</span> `performer` | ✅ |  | 0..* | `BackboneElement` | **Who performed the medication administration and what they did**<br/>Indicates who or what performed the medication administration and how they were involved. |
| <span style="padding-left: 3.0em;">↳</span> `actor` | ✅ |  | 1..1 | `Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-device</span> | **Who performed the medication administration**<br/>Indicates who or what performed the medication administration. |
| <span style="padding-left: 1.5em;">↳</span> `request` | ✅ |  | 0..1 | `Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest</span> | **Request administration performed against**<br/>The original request, instruction or authority to perform the administration. |
| <span style="padding-left: 1.5em;">↳</span> `dosage` | ✅ |  | 0..1 | `BackboneElement` | **Details of how medication was taken**<br/>Describes the medication dosage information details e.g. dose, rate, site, route, etc. |
| <span style="padding-left: 3.0em;">↳</span> `text` | ✅ |  | 0..1 | `string` | **Free text dosage instructions e.g. SIG**<br/>Free text dosage can be used for cases where the dosage administered is too complex to code. When coded dosage is present, the free text dosage may still be present for display to humans.

The dosage instructions should reflect the dosage of the medication that was administered. |
| <span style="padding-left: 3.0em;">↳</span> `route` | ✅ |  | 0..1 | `CodeableConcept` | **Path of substance into body**<br/>A code specifying the route or physiological path of administration of a therapeutic agent into or onto the patient.  For example, topical, intravenous, etc.<br/><span style="font-size: 0.85em;">**Binding:** `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.22` (extensible) — SNOMED CT and NCI Thesaurus SPL route of administration codes</span> |
| <span style="padding-left: 3.0em;">↳</span> `dose` | ✅ |  | 0..1 | `Quantity`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/StructureDefinition/SimpleQuantity\|4.0.1</span> | **Amount of medication per dose**<br/>The amount of the medication given at one administration event.   Use this value when the administration is essentially an instantaneous event such as a swallowing a tablet or giving an injection.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/ucum-common` (preferred)</span> |





```

**Usages:**

* Examples for this Profile: [MedicationAdministration/dose-not-given](MedicationAdministration-dose-not-given.md), [MedicationAdministration/inpatient-iv-cefazolin](MedicationAdministration-inpatient-iv-cefazolin.md), [MedicationAdministration/inprogress-vancomycin](MedicationAdministration-inprogress-vancomycin.md) and [MedicationAdministration/prn-acetaminophen-given](MedicationAdministration-prn-acetaminophen-given.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.us.healthedata1-sandbox|current/StructureDefinition/StructureDefinition-us-core-medicationadministration.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-us-core-medicationadministration.csv), [Excel](StructureDefinition-us-core-medicationadministration.xlsx), [Schematron](StructureDefinition-us-core-medicationadministration.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "us-core-medicationadministration",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 3
  }],
  "url" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationadministration",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.2.42.74"
  }],
  "version" : "0.1.0",
  "name" : "USCoreMedicationAdministrationProfile",
  "title" : "US Core MedicationAdministration Profile",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-05-13",
  "publisher" : "HL7 International / Cross-Group Projects",
  "contact" : [{
    "name" : "HL7 International / Cross-Group Projects",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/cgp"
    },
    {
      "system" : "email",
      "value" : "cgp@lists.HL7.org"
    }]
  }],
  "description" : "The US Core MedicationAdministration Profile inherits from the FHIR [MedicationAdministration](https://hl7.org/fhir/R4/medicationadministration.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) *Medication Administration Data Element of the Medications Data Class*. It sets minimum expectations for the MedicationAdministration resource to record, search, and fetch information about medications administered to a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "w3c.prov",
    "uri" : "http://www.w3.org/ns/prov",
    "name" : "W3C PROV"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "MedicationAdministration",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/MedicationAdministration",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "MedicationAdministration",
      "path" : "MedicationAdministration",
      "mustSupport" : false
    },
    {
      "id" : "MedicationAdministration.status",
      "path" : "MedicationAdministration.status",
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.medication[x]",
      "path" : "MedicationAdministration.medication[x]",
      "type" : [{
        "code" : "CodeableConcept"
      },
      {
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-medication"]
      }],
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4"
      }
    },
    {
      "id" : "MedicationAdministration.subject",
      "path" : "MedicationAdministration.subject",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
        "http://hl7.org/fhir/StructureDefinition/Group"],
        "_targetProfile" : [{
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : true
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        }]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.effective[x]",
      "path" : "MedicationAdministration.effective[x]",
      "type" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
          "valueBoolean" : true
        }],
        "code" : "dateTime"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
          "valueBoolean" : true
        }],
        "code" : "Period"
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.performer",
      "path" : "MedicationAdministration.performer",
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.performer.actor",
      "path" : "MedicationAdministration.performer.actor",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-device"],
        "_targetProfile" : [{
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : true
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        }]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.request",
      "path" : "MedicationAdministration.request",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.dosage",
      "path" : "MedicationAdministration.dosage",
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.dosage.text",
      "path" : "MedicationAdministration.dosage.text",
      "mustSupport" : true
    },
    {
      "id" : "MedicationAdministration.dosage.route",
      "path" : "MedicationAdministration.dosage.route",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "description" : "SNOMED CT and NCI Thesaurus SPL route of administration codes",
        "valueSet" : "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.22"
      }
    },
    {
      "id" : "MedicationAdministration.dosage.dose",
      "path" : "MedicationAdministration.dosage.dose",
      "mustSupport" : true,
      "binding" : {
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet",
          "valueCanonical" : "http://hl7.org/fhir/ValueSet/ucum-units"
        }],
        "strength" : "preferred",
        "valueSet" : "http://hl7.org/fhir/ValueSet/ucum-common"
      }
    }]
  }
}

```
