Prescription

A prescription or medication order issued by a healthcare provider authorizing dispensing and administration of medications to a patient. Captures prescriber details, medication specifications, dispensing instructions, refill allowances, and validity periods for pharmacy integration and patient safety.

Overview

Prescription represents a formal medication order from a licensed prescriber. It specifies what medication to dispense, how much, dosing instructions, number of refills, and validity period. The entity supports the full prescription lifecycle from draft through active dispensing to completion or cancellation. It handles both simple outpatient prescriptions and complex controlled substance orders requiring special handling.

Key Concepts

Prescription Status

The status field tracks order lifecycle:

StatusDescriptionDispense Allowed
draftBeing composedNo
activeReady for dispensingYes
on-holdTemporarily pausedNo
completedFully dispensedNo more
cancelledVoided before useNo
stoppedDiscontinuedNo more
entered-in-errorInvalid recordNo

Order Intent

The intent field clarifies the order type:

IntentDescriptionUse Case
orderActionable prescriptionStandard Rx
original-orderFirst prescriptionNew medication
reflex-orderAuto-generatedProtocol-based
filler-orderPharmacy-initiatedTherapeutic sub
proposalRecommendationE-consult
planFuture intentDischarge planning

Priority

The priority field indicates urgency:

PriorityResponse TimeScenario
routineNormalMaintenance meds
urgentSame dayAcute infection
asapHoursWorsening condition
statImmediateEmergency

Prescriber

The prescriber links to Practitioner:

  • Must have prescriptive authority
  • DEA registration for controlled substances
  • Establishes order accountability

Dosing Instructions

Dosing is captured multiple ways:

  • dosageInstruction - Full text sig
  • dosageFrequency - Structured frequency
  • doseQuantity / doseUnit - Per-dose amount
  • route - Administration route

Dispensing Quantities

For pharmacy fulfillment:

  • dispenseQuantity / dispenseUnit - Amount per fill
  • expectedSupplyDays - Days supply
  • numberOfRepeatsAllowed - Refills authorized
  • refillsRemaining (calculated) - Refills left

Validity Period

The validityPeriod defines when prescription is valid:

  • Start date (usually authored date)
  • End date (expiration)
  • Controlled substances have shorter windows
  • State regulations may apply

Substitution

Substitution policy:

  • substitutionAllowed - Generic permitted
  • substitutionReason - Why brand required
  • DAW (Dispense As Written) codes
  • Medical necessity documentation

Clinical Indication

Why the medication was prescribed:

  • reasonCode - ICD-10/SNOMED codes
  • reasonText - Free-text explanation
  • Supports prior authorization
  • Quality measure documentation

Use Cases

New Prescription

Writing a new order:

  1. Select medication
  2. Set dosing instructions
  3. Specify quantity and refills
  4. Set validity period
  5. Document indication
  6. Sign/authorize
  7. Transmit to pharmacy

Controlled Substance

For Schedule II-V medications:

  1. Verify DEA registration
  2. Check PDMP (Prescription Drug Monitoring Program)
  3. Apply appropriate refill limits
  4. Use EPCS if required
  5. Document medical necessity
  6. Set shorter validity period

Prescription Modification

When changing existing order:

  1. Reference priorPrescription
  2. Create new prescription
  3. Cancel or stop prior order
  4. Document reason for change
  5. Notify pharmacy

Refill Authorization

For ongoing therapy:

  1. Set appropriate numberOfRepeatsAllowed
  2. Consider total therapy duration
  3. Account for 90-day supplies
  4. Enable pharmacy refill processing
  5. Track refills remaining

Prior Authorization

When insurance requires approval:

  1. Document reasonCode thoroughly
  2. Include clinical notes
  3. Submit to payer
  4. Track authorization status
  5. Dispense when approved

Related Entities

EntityRelationshipDescription
PatientReferencesWho medication is for
EncounterReferencesVisit context
MedicationReferencesDrug prescribed
PractitionerReferencesPrescriber
ClinicalIdentifierContainsPrescription identifiers
PeriodContainsValidity window
FrequencyContainsDosing frequency
CodingContainsReason codes
PrescriptionLineHas manyIndividual medication lines
MedicationDispenseReferenced byDispensing events
PrescriptionReferencesPrior prescription replaced

Calculated Fields

FieldTypeDescription
isActivebooleanTrue when status is active
isExpiredbooleanTrue when past validity period
refillsRemainingnumberAuthorized refills minus dispenses
daysSupplyRemainingnumberEstimated days until medication runs out
isControlledSubstancebooleanTrue when medication is DEA scheduled
requiresElectronicPrescribingbooleanTrue when EPCS required

Enums

status

ValueDescription
activePrescription is valid and available for dispensing
on-holdPrescription temporarily paused
cancelledPrescription cancelled before dispensing
completedPrescription fully dispensed with no refills remaining
entered-in-errorPrescription created in error
stoppedPrescription discontinued during therapy
draftPrescription being composed, not yet authorized
unknownPrescription status cannot be determined

intent

ValueDescription
proposalSuggestion for prescriber consideration
planIntended future order, not yet actionable
orderActionable prescription ready for dispensing
original-orderFirst prescription for this medication
reflex-orderAuto-generated based on protocol
filler-orderCreated by pharmacy (therapeutic substitution)
instance-orderSingle instance of a recurring order

priority

ValueDescription
routineNormal processing, no urgency
urgentSame-day dispensing needed
asapDispense as soon as possible, within hours
statImmediate dispensing required

route

ValueDescription
oralAdministered by mouth
intravenousAdministered into a vein
intramuscularInjected into muscle
subcutaneousInjected under the skin
topicalApplied to skin surface
inhalationBreathed into lungs
nasalAdministered into nose
ophthalmicApplied to the eye
oticApplied to the ear
rectalAdministered into rectum
vaginalAdministered into vagina
transdermalAbsorbed through skin
otherOther route not listed
31 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
identifierClinicalIdentifier[]
stored

Unique identifiers for this prescription assigned by different systems (e.g., institutional prescription number, e-prescribing ID, pharmacy system ID)

Example: [{"@type":"ClinicalIdentifier","value":"RX-2024-123456","type":"prescription"}]

Optional
patientPatient
stored

Reference to the patient for whom this medication is prescribed

Required
encounterEncounter
stored

Reference to the healthcare encounter during which this prescription was created (e.g., office visit, hospital admission, telemedicine consultation)

Optional
medicationMedication
stored

The medication being prescribed with standardized coding (RxNorm, NDC, ATC)

Required
statusstring
stored

Current status of the prescription in its lifecycle

Values: active, on-hold, cancelled, completed, entered-in-error, stopped, draft, unknown

Example: "active"

Required
intentstring
stored

The intent or purpose of the prescription order

Values: proposal, plan, order, original-order, reflex-order, filler-order, instance-order

Example: "order"

Required
prioritystring
stored

Urgency level for dispensing and administration of the medication

Values: routine, urgent, asap, stat

Example: "routine"

Optional
prescriberPractitioner
stored

Reference to the healthcare provider who authorized and signed the prescription

Required
authoredOnDateTime
stored

Date and time when the prescription was originally written and authorized by the prescriber

Example: "2024-11-15T10:30:00Z"

Required
validityPeriodPeriod
stored

Time period during which the prescription is valid and can be dispensed (prescription expiration window)

Example: {"@type":"Period","start":"2024-11-15T10:30:00Z","end":"2025-11-15T10:30:00Z"}

Optional
dosageInstructionstring
stored

Complete instructions for how the patient should take or use the medication, including dose, route, frequency, and duration

Example: "Take 1 tablet by mouth twice daily with food for 10 days"

Optional
dosageFrequencyFrequency
stored

Structured frequency specification for medication administration timing

Example: {"@type":"Frequency","count":2,"period":1,"periodUnit":"day","timeOfDay":["08:00","20:00"],"when":"with-meal"}

Optional
doseQuantitynumber
stored

Amount of medication per dose (e.g., 1 tablet, 5 mL, 10 mg)

Example: 1

Optional
doseUnitstring
stored

Unit of measure for the dose quantity

Example: "tablet"

Optional
routestring
stored

Route of administration for the medication

Values: oral, intravenous, intramuscular, subcutaneous, topical, inhalation, nasal, ophthalmic, otic, rectal, vaginal, transdermal, other

Example: "oral"

Optional
numberOfRepeatsAllowednumber
stored

Number of refills authorized by the prescriber (0 means no refills allowed)

Example: 3

Optional
dispenseQuantitynumber
stored

Quantity of medication to be dispensed per fill or refill

Example: 30

Optional
dispenseUnitstring
stored

Unit for the dispensed quantity (e.g., tablets, capsules, boxes, bottles, mL)

Example: "tablets"

Optional
expectedSupplyDaysnumber
stored

Expected number of days the dispensed medication will last based on the dosage instructions

Example: 30

Optional
substitutionAllowedboolean
stored

Whether generic or therapeutic substitution is permitted by the prescriber

Example: true

Optional
substitutionReasonstring
stored

Explanation for why substitution is not allowed (e.g., medical necessity, patient intolerance to excipients, narrow therapeutic index)

Example: "Patient has documented intolerance to generic formulation excipients"

Optional
reasonCodeCoding[]
stored

Coded clinical indication or diagnosis justifying why the medication was prescribed (typically ICD-10, SNOMED-CT codes)

Example: [{"@type":"Coding","code":"I10","system":"ICD-10","display":"Essential (primary) hypertension"}]

Optional
reasonTextstring
stored

Free-text explanation of the clinical reasoning or indication for prescribing this medication

Example: "Blood pressure control - patient's BP readings consistently above 140/90"

Optional
notestring
stored

Additional instructions, warnings, or information for the pharmacist and patient (e.g., special handling, patient counseling points, monitoring requirements)

Example: "Monitor blood pressure weekly. Contact prescriber if systolic BP drops below 110."

Optional
priorPrescriptionPrescription
stored

Reference to the previous prescription that this one replaces or modifies (for dose changes, medication switches)

Optional
isActiveboolean
calculated

Whether the prescription is currently active (status is 'active')

Optional
isExpiredboolean
calculated

Whether the prescription has passed its validity period and can no longer be dispensed

Optional
refillsRemainingnumber
calculated

Number of refills still available, calculated from numberOfRepeatsAllowed and actual dispense events tracked in the system

Optional
daysSupplyRemainingnumber
calculated

Estimated days of medication supply remaining based on last dispense date, expected supply days, and current date

Optional
isControlledSubstanceboolean
calculated

Whether the prescribed medication is a DEA controlled substance (Schedule I-V), derived from medication.controlledSubstanceSchedule

Optional
requiresElectronicPrescribingboolean
calculated

Whether this prescription must be transmitted electronically per regulatory requirements (e.g., EPCS for Schedule II-V in certain jurisdictions)

Optional

Examples

Example 1

{
  "@type": "Prescription",
  "identifier": [
    {
      "@type": "ClinicalIdentifier",
      "value": "RX-2024-089456",
      "type": "prescription",
      "use": "official"
    }
  ],
  "patient": {
    "@type": "Patient",
    "givenName": "Michael",
    "familyName": "Chen"
  },
  "encounter": {
    "@type": "Encounter",
    "identifier": [
      {
        "@type": "ClinicalIdentifier",
        "value": "ENC-2024-11234"
      }
    ]
  },
  "medication": {
    "@type": "Medication",
    "code": "308136",
    "system": "RxNorm",
    "label": "Amoxicillin 500 MG Oral Capsule",
    "genericName": "Amoxicillin",
    "form": "capsule",
    "route": "oral",
    "strength": "500 MG",
    "controlledSubstanceSchedule": "not-controlled"
  },
  "status": "active",
  "intent": "order",
  "priority": "routine",
  "prescriber": {
    "@type": "Practitioner",
    "givenName": "Sarah",
    "familyName": "Johnson"
  },
  "authoredOn": "2024-11-15T10:30:00Z",
  "validityPeriod": {
    "@type": "Period",
    "start": "2024-11-15T10:30:00Z",
    "end": "2025-01-15T10:30:00Z"
  },
  "dosageInstruction": "Take 1 capsule by mouth three times daily for 10 days",
  "dosageFrequency": {
    "@type": "Frequency",
    "count": 3,
    "period": 1,
    "periodUnit": "day",
    "timeOfDay": [
      "08:00",
      "14:00",
      "20:00"
    ],
    "maxOccurrences": 30
  },
  "doseQuantity": 1,
  "doseUnit": "capsule",
  "route": "oral",
  "numberOfRepeatsAllowed": 0,
  "dispenseQuantity": 30,
  "dispenseUnit": "capsules",
  "expectedSupplyDays": 10,
  "substitutionAllowed": true,
  "reasonCode": [
    {
      "@type": "Coding",
      "code": "J03.90",
      "system": "ICD-10",
      "display": "Acute tonsillitis, unspecified"
    }
  ],
  "reasonText": "Bacterial pharyngitis - positive rapid strep test",
  "note": "Complete full course even if symptoms improve. Take with food to minimize GI upset."
}

Example 2

{
  "@type": "Prescription",
  "identifier": [
    {
      "@type": "ClinicalIdentifier",
      "value": "RX-2024-123789",
      "type": "prescription",
      "use": "official"
    }
  ],
  "patient": {
    "@type": "Patient",
    "givenName": "Emily",
    "familyName": "Rodriguez"
  },
  "encounter": {
    "@type": "Encounter",
    "identifier": [
      {
        "@type": "ClinicalIdentifier",
        "value": "ENC-2024-22445"
      }
    ]
  },
  "medication": {
    "@type": "Medication",
    "code": "197361",
    "system": "RxNorm",
    "label": "Lisinopril 10 MG Oral Tablet",
    "genericName": "Lisinopril",
    "brandNames": [
      "Prinivil",
      "Zestril"
    ],
    "form": "tablet",
    "route": "oral",
    "strength": "10 MG",
    "therapeuticClass": "ACE Inhibitor",
    "controlledSubstanceSchedule": "not-controlled"
  },
  "status": "active",
  "intent": "order",
  "priority": "routine",
  "prescriber": {
    "@type": "Practitioner",
    "givenName": "David",
    "familyName": "Martinez"
  },
  "authoredOn": "2024-09-01T14:15:00Z",
  "validityPeriod": {
    "@type": "Period",
    "start": "2024-09-01T14:15:00Z",
    "end": "2025-09-01T14:15:00Z"
  },
  "dosageInstruction": "Take 1 tablet by mouth once daily in the morning",
  "dosageFrequency": {
    "@type": "Frequency",
    "count": 1,
    "period": 1,
    "periodUnit": "day",
    "timeOfDay": [
      "08:00"
    ]
  },
  "doseQuantity": 1,
  "doseUnit": "tablet",
  "route": "oral",
  "numberOfRepeatsAllowed": 11,
  "dispenseQuantity": 90,
  "dispenseUnit": "tablets",
  "expectedSupplyDays": 90,
  "substitutionAllowed": true,
  "reasonCode": [
    {
      "@type": "Coding",
      "code": "I10",
      "system": "ICD-10",
      "display": "Essential (primary) hypertension"
    }
  ],
  "reasonText": "Hypertension management - BP consistently 145/92 despite lifestyle modifications",
  "note": "Monitor blood pressure weekly. Report persistent dry cough. Check potassium and creatinine in 2 weeks."
}

Example 3

{
  "@type": "Prescription",
  "identifier": [
    {
      "@type": "ClinicalIdentifier",
      "value": "RX-2024-456123",
      "type": "prescription",
      "use": "official",
      "clinicalSystem": "custom"
    },
    {
      "@type": "ClinicalIdentifier",
      "value": "EPCS-2024-CS-789456",
      "type": "e-prescription",
      "use": "official"
    }
  ],
  "patient": {
    "@type": "Patient",
    "givenName": "Robert",
    "familyName": "Anderson"
  },
  "encounter": {
    "@type": "Encounter",
    "identifier": [
      {
        "@type": "ClinicalIdentifier",
        "value": "ENC-2024-33789"
      }
    ]
  },
  "medication": {
    "@type": "Medication",
    "code": "1049502",
    "system": "RxNorm",
    "label": "Oxycodone 5 MG Oral Tablet",
    "genericName": "Oxycodone",
    "brandNames": [
      "OxyContin",
      "Roxicodone"
    ],
    "form": "tablet",
    "route": "oral",
    "strength": "5 MG",
    "therapeuticClass": "Opioid Analgesic",
    "controlledSubstanceSchedule": "II"
  },
  "status": "active",
  "intent": "order",
  "priority": "routine",
  "prescriber": {
    "@type": "Practitioner",
    "givenName": "Jennifer",
    "familyName": "Williams"
  },
  "authoredOn": "2024-11-20T09:45:00Z",
  "validityPeriod": {
    "@type": "Period",
    "start": "2024-11-20T09:45:00Z",
    "end": "2024-12-20T09:45:00Z"
  },
  "dosageInstruction": "Take 1 tablet by mouth every 6 hours as needed for severe pain. Do not exceed 4 tablets in 24 hours.",
  "dosageFrequency": {
    "@type": "Frequency",
    "count": 1,
    "period": 6,
    "periodUnit": "hour",
    "asNeeded": true,
    "maxPerDay": 4
  },
  "doseQuantity": 1,
  "doseUnit": "tablet",
  "route": "oral",
  "numberOfRepeatsAllowed": 0,
  "dispenseQuantity": 20,
  "dispenseUnit": "tablets",
  "expectedSupplyDays": 5,
  "substitutionAllowed": false,
  "substitutionReason": "Controlled substance Schedule II - no refills or substitutions permitted by federal regulation",
  "reasonCode": [
    {
      "@type": "Coding",
      "code": "M25.561",
      "system": "ICD-10",
      "display": "Pain in right knee"
    }
  ],
  "reasonText": "Acute post-operative pain management following knee arthroscopy",
  "note": "DEA Schedule II controlled substance. Federal law prohibits refills. Patient counseled on opioid risks, safe storage, and disposal. Prescription Drug Monitoring Program checked. Risk assessment completed. Do not drive or operate machinery while taking this medication."
}