MedicationRequest - FHIR Resource (r4)


This MedicationRequest Resource uses the FHIR API standard for access and structure.

Validate an MedicationRequest FHIR Resource (r4)



Resource Attributes

AttributeField is listTypeDescription
authoredOnfalsedateTime# When request was initially authored
basedOntrueReference# "basedOn" : [{ Reference(CarePlan|MedicationRequest|ServiceRequest|
categorytrueCodeableConcept# Type of medication usage
courseOfTherapyTypefalseCodeableConcept# Overall pattern of medication administration
detectedIssuetrueReference# Clinical Issue with action
dispenseRequestfalseData Type# Medication supply authorization
doNotPerformfalseboolean# True if request is prohibiting action
dosageInstructiontrueDosage# How the medication should be taken
encounterfalseReference# Encounter created as part of encounter/admission/stay
eventHistorytrueReference# A list of events of interest in the lifecycle
groupIdentifierfalseIdentifier# Composite request this is part of
identifiertrueIdentifier# External ids for this request
instantiatesCanonicaltruecanonical# Instantiates FHIR protocol or definition
instantiatesUritrueuri# Instantiates external protocol or definition
insurancetrueReference# Associated insurance coverage
intentfalsecode# proposal | plan | order | original-order | reflex-order | filler-order | instance-order | option
medication[x]falseReference#undefined
notetrueAnnotation# Information about the prescription
performerfalseReference# "performer" : { Reference(Practitioner|PractitionerRole|Organization|
performerTypefalseCodeableConcept# Desired kind of performer of the medication administration
priorPrescriptionfalseReference# An order/prescription that is being replaced
priorityfalsecode# routine | urgent | asap | stat
reasonCodetrueCodeableConcept# Reason or indication for ordering or not ordering the medication
reasonReferencetrueReference# Condition or observation that supports why the prescription is being written
recorderfalseReference# Person who entered the request
reported[x]falseReference#undefined
requesterfalseReference# "requester" : { Reference(Practitioner|PractitionerRole|Organization|
statusfalsecode# active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown
statusReasonfalseCodeableConcept# Reason for current status
subjectfalseReference# Who or group medication request is for
substitutionfalseData Type# Any restrictions on medication substitution
supportingInformationtrueReference# Information to support ordering of the medication

MedicationRequest Example

{
  "resourceType": "MedicationRequest",
  "id": "medrx002",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative with Details</b></p><p><b>id</b>: medrx002</p><p><b>identifier</b>: 12345 (OFFICIAL)</p><p><b>status</b>: active</p><p><b>intent</b>: order</p><p><b>medication</b>: <a>prescribed medication</a></p><p><b>subject</b>: <a>Donald Duck</a></p><p><b>encounter</b>: <a>encounter that leads to this prescription</a></p><p><b>authoredOn</b>: 01/03/2015</p><p><b>requester</b>: <a>Patrick Pump</a></p><p><b>reasonCode</b>: Essential hypertension (disorder) <span>(Details : {SNOMED CT code '59621000' = 'Essential hypertension', given as 'Essential hypertension (disorder)'})</span></p><p><b>dosageInstruction</b>: </p></div>"
  },
  "identifier": [
    {
      "use": "official",
      "system": "http://www.bmc.nl/portal/prescriptions",
      "value": "12345"
    }
  ],
  "status": "active",
  "intent": "order",
  "medicationReference": {
    "reference": "Medication/med0316",
    "display": "prescribed medication"
  },
  "subject": {
    "reference": "Patient/pat1",
    "display": "Donald Duck"
  },
  "encounter": {
    "reference": "Encounter/f001",
    "display": "encounter that leads to this prescription"
  },
  "authoredOn": "2015-03-01",
  "requester": {
    "reference": "Practitioner/f007",
    "display": "Patrick Pump"
  },
  "reasonCode": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "59621000",
          "display": "Essential hypertension (disorder)"
        }
      ]
    }
  ],
  "dosageInstruction": [
    {
      "sequence": 1,
      "text": "Take one tablet daily as directed"
    }
  ]
}

MedicationRequest Structure

{
  "resourceType" : "MedicationRequest",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External ids for this request
  "status" : "<code>", // R!  active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown
  "statusReason" : { CodeableConcept }, // Reason for current status
  "intent" : "<code>", // R!  proposal | plan | order | original-order | reflex-order | filler-order | instance-order | option
  "category" : [{ CodeableConcept }], // Type of medication usage
  "priority" : "<code>", // routine | urgent | asap | stat
  "doNotPerform" : <boolean>, // True if request is prohibiting action
  // reported[x]: Reported rather than primary record. One of these 2:
  "reportedBoolean" : <boolean>,
  "reportedReference" : { Reference(Patient|Practitioner|PractitionerRole|
   RelatedPerson|Organization) },
  // medication[x]: Medication to be taken. One of these 2:
  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "subject" : { Reference(Patient|Group) }, // R!  Who or group medication request is for
  "encounter" : { Reference(Encounter) }, // Encounter created as part of encounter/admission/stay
  "supportingInformation" : [{ Reference(Any) }], // Information to support ordering of the medication
  "authoredOn" : "<dateTime>", // When request was initially authored
  "requester" : { Reference(Practitioner|PractitionerRole|Organization|
   Patient|RelatedPerson|Device) }, // Who/What requested the Request
  "performer" : { Reference(Practitioner|PractitionerRole|Organization|
   Patient|Device|RelatedPerson|CareTeam) }, // Intended performer of administration
  "performerType" : { CodeableConcept }, // Desired kind of performer of the medication administration
  "recorder" : { Reference(Practitioner|PractitionerRole) }, // Person who entered the request
  "reasonCode" : [{ CodeableConcept }], // Reason or indication for ordering or not ordering the medication
  "reasonReference" : [{ Reference(Condition|Observation) }], // Condition or observation that supports why the prescription is being written
  "instantiatesCanonical" : ["<canonical>"], // Instantiates FHIR protocol or definition
  "instantiatesUri" : ["<uri>"], // Instantiates external protocol or definition
  "basedOn" : [{ Reference(CarePlan|MedicationRequest|ServiceRequest|
   ImmunizationRecommendation) }], // What request fulfills
  "groupIdentifier" : { Identifier }, // Composite request this is part of
  "courseOfTherapyType" : { CodeableConcept }, // Overall pattern of medication administration
  "insurance" : [{ Reference(Coverage|ClaimResponse) }], // Associated insurance coverage
  "note" : [{ Annotation }], // Information about the prescription
  "dosageInstruction" : [{ Dosage }], // How the medication should be taken
  "dispenseRequest" : { // Medication supply authorization
    "initialFill" : { // First fill details
      "quantity" : { Quantity(SimpleQuantity) }, // First fill quantity
      "duration" : { Duration } // First fill duration
    },
    "dispenseInterval" : { Duration }, // Minimum period of time between dispenses
    "validityPeriod" : { Period }, // Time period supply is authorized for
    "numberOfRepeatsAllowed" : "<unsignedInt>", // Number of refills authorized
    "quantity" : { Quantity(SimpleQuantity) }, // Amount of medication to supply per dispense
    "expectedSupplyDuration" : { Duration }, // Number of days supply per dispense
    "performer" : { Reference(Organization) } // Intended dispenser
  },
  "substitution" : { // Any restrictions on medication substitution
    // allowed[x]: Whether substitution is allowed or not. One of these 2:
    "allowedBoolean" : <boolean>,
    "allowedCodeableConcept" : { CodeableConcept },
    "reason" : { CodeableConcept } // Why should (not) substitution be made
  },
  "priorPrescription" : { Reference(MedicationRequest) }, // An order/prescription that is being replaced
  "detectedIssue" : [{ Reference(DetectedIssue) }], // Clinical Issue with action
  "eventHistory" : [{ Reference(Provenance) }] // A list of events of interest in the lifecycle
}

MedicationRequest Search Parameters

The following search parameters can be used to query MedicationRequest resources. Just submit them like so:

https://api.1up.health/fhir/r4/MedicationRequest?query-param=queryvalue
Search ParameterField TypeResource Fields Searched
authoredondateauthoredOn
categorytextcategory
codetextmedication
datedatedosageInstruction.timing.event
encounterreferenceencounter
identifiertextidentifier
intended-dispenserreferencedispenseRequest.performer
intended-performerreferenceperformer
intended-performertypetextperformerType
intenttextintent
medicationreferencemedication
patientreferencesubject.where
prioritytextpriority
requesterreferencerequester
statustextstatus
subjectreferencesubject