Salesforce Docs Portal

MedicationRequest

Represents a request or order for the supply of medication, along with information about how it should be administered. This object is available in API version 51.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Additional Information for MedicationRequest in Other Objects

In addition to creating a record using these fields, you can add more details to your MedicationRequest record by creating records in certain other objects, and referencing your MedicationRequest record as the parent record. Here’s the list of objects you can associate to MedicationRequest in this way, the type of information they add, and the field they use to reference MedicationRequest.

Object Type of Information Reference Field
Identifier Associates an identifier value to the medication request. ParentRecordId
PatientMedicationDosage Associates dosage-related information for the medication in the medication request record. ParentRecordId

Fields

AllowedSubstitutionTypeCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the type of substitution that's allowed. This field can’t be used if the CanSubstitute field is set to true.
  • Referenced Objects:
    • CodeSetBundle

CanSubstitute

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether substitution is acceptable. If the value for this field is set to true, then the AllowedSubstitutionTypeCodeId field can’t be selected.

CarePlanId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The care plan related to this medication request. This field is a relationship field.
  • Relationship Name: CarePlan
  • Relationship Type: Lookup
  • Referenced Objects:
    • CarePlan

CaseId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The case associated with the medication request.

    This field is a relationship field.

  • Relationship Name: Case
  • Refers To: Case

ClinicalEncounterId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The clinical encounter related to the medication request.
  • Referenced Objects:
    • ClinicalEncounter

ClinicalServiceRequestId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: References the service request related to the medication request.
  • Referenced Objects:
    • ClinicalServiceRequest

DispenseInterval

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The minimum interval required between refills.

DispenseIntervalUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit for that interval.
  • Referenced Objects:
    • UnitOfMeasure

DispenserId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The person who provides the medication.
  • Referenced Objects:
    • Account

FillDurationUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit for the fill duration.
  • Referenced Objects:
    • UnitOfMeasure

FillQuantityUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit of the fill quantity.
  • Referenced Objects:
    • UnitOfMeasure

InitialFillDuration

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The length of time the first fill is expected to last.

InitialFillQuantity

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The quantity to be filled in the first dispense.

IsIgnored

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether the request should be ignored.

IsSecondaryInformation

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether the request is based on information from a secondary source instead of a primary one. If this field is set to true, then the SecondarySourceId field can’t be selected.

LastReferencedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The most recent date on which a user referenced this record.

LastViewedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The most recent date on which a user viewed this record.

MedicationAdministrationContextId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the setting in which the medication is administered.
  • Referenced Objects:
    • CodeSetBundle

MedicationCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that specifies the medication requested. A record can select either a MedicationId or a MedicationCodeId, but not both.
  • Referenced Objects:
    • CodeSetBundle

MedicationId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Lookup to the medication record for the medicine requested. A record can select either a MedicationId or a MedicationCodeId, but not both.
  • Referenced Objects:
    • Medication

MedicationRequestGroupId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A shared identifier common to all medication requests that were authorized more or less simultaneously by a single author.
  • Referenced Objects:
    • Identifier

Name

  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: The system-generated name of the medication request record.

OwnerId

  • Type: reference
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: The owner of the medication request record. Available in API version 56.0 and later. This is a polymorphic relationship field.
  • Relationship Name: Owner
  • Relationship Type: Lookup
  • Referenced Objects:
    • Group
    • User

PatientId

  • Type: Master-detail reference
  • Properties: Create, Filter, Group, Sort
  • Description: The person who needs the medicine.
  • Referenced Objects:
    • Account

PerformerId

  • Type: Polymorphic reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The person who administers the medicine.
  • Referenced Objects:
    • Account
    • HealthcareProvider
    • CareRegisteredDevice

PerformerTypeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the performer's role. For instance, the cardiologist, neurosurgeon, and so on.
  • Referenced Objects:
    • CodeSetBundle

PrescribedDate

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The date and optionally the time when the prescription was initially written or authored on.

PrescriptionPeriodEnd

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The end date for the prescription's validity.

PrescriptionPeriodStart

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The start date for the prescription's validity.

PreviousPrescriptionId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Reference to previous prescriptions.
  • Referenced Objects:
    • MedicationRequest

Priority

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the priority of the request.
  • Possible values:
    • ASAP
    • Routine
    • Stat
    • Urgent

ReasonCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The code for why the medicine was requested.
  • Referenced Objects:
    • CodeSetBundle

ReasonReferenceId

  • Type: Polymorphic reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Reference to the condition or observation that warranted this medicine.
  • Referenced Objects:
    • HealthCondition
    • CareObservation

RefillDuration

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: How long the refill is expected to last.

RefillQuantity

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The quantity in each refill.

RefillsAllowed

  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The number of refills that are allowed.

RelatedRequestId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A plan or request that is fulfilled in whole or in part by this medication request.
  • Referenced Objects:
    • MedicationRequest

RequesterId

  • Type: Polymorphic reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The person who raised the request.
  • Referenced Objects:
    • Account
    • HealthcareProvider
    • CareRegisteredDevice

SecondarySourceId

  • Type: Polymorphic reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: References the person who gave the information for the request. This field can’t be selected if the IsSecondarySource field is set to true.
  • Referenced Objects:
    • Account
    • HealthcareProvider

SourceSystem

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The name of the system this record came from.

SourceSystemIdentifier

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ID of this record in its source system.

SourceSystemModified

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The date on which this item was last changed in the source system.

Status

  • Type: picklist
  • Properties: Create, Filter, Group, Sort, Update
  • Description: The status of the medication request.
  • Possible values:
    • Active
    • Cancelled
    • Completed
    • Draft
    • Entered-in-Error
    • On-Hold
    • Stopped
    • Unknown

StatusReasonCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that specifies the reason for the status.
  • Referenced Objects:
    • CodeSetBundle

SubstitutionReasonCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies why a substitution is required.
  • Referenced Objects:
    • CodeSetBundle

TherapyDuration

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The description of the overall pattern of the administration of the medication to the patient. For instance, Continuous, Acute, Seasonal.
  • Possible values:
    • Continuous
    • Seasonal
    • Short Term

Type

  • Type: picklist
  • Properties: Create, Filter, Group, Sort, Update
  • Description: The type of the request.
  • Possible values:
    • Filler Order
    • Instance Order
    • Option
    • Order
    • Original Order
    • Plan
    • Proposal
    • Reflex Order

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

MedicationRequestChangeEvent (API version 59.0)
Change events are available for the object.
MedicationRequestFeed
Feed tracking is available for the object.
MedicationRequestHistory
History is available for tracked fields of the object.
MedicationRequestOwnerSharingRule (API version 56.0)
Sharing rules are available for the object.
MedicationRequestShare (API version 56.0)
Sharing is available for the object.