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()

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

Fields

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

CaseId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The case associated with the patient’s medication statement.

This field is a relationship field.
Relationship Name: Case
Refers To: Case

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:
- 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.

OwnerId

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

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:
- 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

Associated Objects

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

MedicationStatementChangeEvent (API version 58.0): Change events are available for the object.
MedicationStatementFeed: Feed tracking is available for the object.
MedicationStatementHistory: History is available for tracked fields of the object.
MedicationStatementOwnerSharingRule (API version 56.0): Sharing rules are available for the object.
MedicationStatementShare (API version 56.0): Sharing is available for the object.

See Also

MedicationStatementDetail