The MedicationRequest resource implements the FHIR R4 MedicationRequest specification and US Core v3.1.1 MedicationRequest profile

Fields

Name Type Cardinality Required Description
identifier Identifier 0..*   External ids for this request
status code 1..1 * active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown
statusReason CodeableConcept 0..1   Reason for current status
intent code 1..1 * proposal | plan | order | original-order | reflex-order | filler-order | instance-order | option
category CodeableConcept 0..1   Type of medication usage
priority code 0..1   routine | urgent | stat | asap
doNotPerform boolean 0..1   True if request is prohibiting action
reportedBoolean boolean 0..1   Reported rather than primary record
reportedReference reference 0..1   Reported rather than primary record
medicationCodeableConcept CodeableConcept 1..1 * Medication to be taken
subject Reference(US Core Patient Profile) 1..1 * Who or group medication request is for
encounter Reference 0..1   Encounter created as part of encounter/admission/stay
supportingInformation Reference 0..*   Information to support ordering of the medication
authoredOn dateTime 1..1 * When request was initially authored
requester Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) 1..1 * Who/What requested the Request
performer Reference 0..1   Intended performer of administration
performerType CodeableConcept 0..1   Desired kind of performer of the medication administration
recorder Reference 0..1   Person who entered the request
reasonCode CodeableConcept 0..*   Reason or indication for ordering or not ordering the medication
reasonReference Reference 0..*   Condition or observation that supports why the prescription is being written
instantiatesCanonical canonical 0..*   Instantiates FHIR protocol or definition
instantiatesUri uri 0..*   Instantiates external protocol or definition
basedOn Reference 0..*   What request fulfills
groupIdentifier Identifier 0..1   Composite request this is part of
courseOfTherapyType CodeableConcept 0..1   Overall pattern of medication administration
insurance Reference 0..*   Associated insurance coverage
note Annotation 0..*   Information about the prescription
dosageInstruction Dosage 0..*   How the medication should be taken
dosageInstruction.text string 0..1   Free text dosage instructions e.g. SIG
dispenseRequest BackboneElement 0..1   Medication supply authorization
substitution BackboneElement 0..1   Any restrictions on medication substitution
priorPrescription Reference 0..1   An order/prescription that is being replaced
detectedIssue Reference 0..*   Clinical Issue with action
eventHistory Reference 0..*   A list of events of interest in the lifecycle

Interactions

Read

Get an MedicationRequest entry by id

GET /MedicationRequest/:id

Example

Request

https://r4cert.medicasoft.us/api/fhir/MedicationRequest/00100c01-7f21-6d09-c332-cef2c85fefaf

Response

{
  "resourceType": "MedicationRequest",
  "status": "active",
  "intent": "plan",
  "reportedBoolean": true,
  "medicationCodeableConcept": {
    "coding": [
      {
        "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
        "code": "313988",
        "display": "Furosemide 40 MG Oral Tablet"
      }
    ],
    "text": "Furosemide 40 MG Oral Tablet"
  },
  "subject": {
    "reference": "Patient/bcfa83df-ee8c-9721-cc07-bdcfc2b1e3f2"
  },
  "authoredOn": "1994-08-31T00:56:44-04:00",
  "requester": {
    "reference": "Patient/bcfa83df-ee8c-9721-cc07-bdcfc2b1e3f2"
  },
  "reasonReference": [
    {
      "reference": "Condition/e744b591-28eb-fb5a-f79d-c11342d243cb"
    }
  ],
  "dosageInstruction": [
    {
      "text": "Take as needed.",
      "asNeededBoolean": true
    }
  ],
  "id": "00100c01-7f21-6d09-c332-cef2c85fefaf"
}

Query MedicationRequest resources

GET /MedicationRequest?:query_parameters

Parameters

Name Type Description
authoredon date Return prescriptions written on this date
date date Returns medication request to be administered on a specific date
identifier token Return prescriptions with this external identifier
intent token Returns prescriptions with different intents
medication reference Return prescriptions of this medication reference
patient reference Returns prescriptions for a specific patient
status token Status of the prescription
subject reference The identity of a patient to list orders for
_include undefined MedicationRequest:medication | MedicationRequest.medication
_revinclude   Provenance:target

Errors

Code Description
400 Invalid parameters
404 Resource not found