Newer Version Available

This content describes an older version of this product. View Latest

MedicationStatement

Represents a record of medication that the patient is currently taking or has taken in the past. 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()

Fields

Field Details
AssertionDateTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time the medication statement was made.
CareObservationId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The observation that warranted this medication.
Referenced Objects
  • CareObservation
ClinicalEncounterId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The encounter related to the medication statement.
Referenced Objects
  • ClinicalEncounter
DeliverySetting
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Specifies the setting in which the medication was administered.
Possible values are:
  • Community
  • Inpatient
  • Outpatient
  • PatientSpecified
EndDateTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The stated end date and time for the medication.
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.
MedicationCodeId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The system-defined code that identifies a medication. 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
The medication associated with this medication statement. A record can select either a MedicationId or a MedicationCodeId, but not both.
Referenced Objects
  • Medication
MedicationReasonCodeId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The system-defined code that specifies the reason this medication was taken.
Referenced Objects
  • CodeSetBundle
MedicationReasonId
Type
Polymorphic reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The observation, condition, or diagnostic report that warranted the medication.
Referenced Objects
  • HealthCondition
  • CareObservation
MedicationRequestId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
A medication request associated with the medication statement.
Referenced Objects
  • MedicationRequest
Name
Type
string
Properties
Autonumber, Defaulted on create, Filter, idLookup, Sort
Description
The system-generated name of the medication statement record.
ParentMedicationStatementId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The parent medication statement associated with the medication statement.
Referenced Objects
  • MedicationStatement
PatientId
Type
Master-detail reference
Properties
Create, Filter, Group, Sort
Description
A patient that the medication statement refers to.
Referenced Objects
  • Account
ProcedureId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The procedure associated with this medication statement.
Referenced Objects
  • PatientMedicalProcedure
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.
StartDateTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The stated start date and time for the medication.
StatementSourceId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The person who made the medication statement.
Status
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Specifies the status of the medication in this statement.
Possible values are:
  • Active
  • Completed
  • Entered-in-error
  • Intended
  • Not-taken
  • On-hold
  • Review Pending - This picklist value is available for the Home Health feature in API version 59.0 and later.
  • 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

Additional Information for MedicationStatement in Other Objects

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

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

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

MedicationStatementFeed
Feed tracking is available for the object.
MedicationStatementHistory
History is available for tracked fields of the object.