Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

OpportunityFieldHistory

Represents the history of changes to the values in the fields of an opportunity. This object is available in versions 13.0 and later.

Supported Calls

describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

You can also enable delete() in API version 42.0 and later. See Enable delete of Field History and Field History Archive.

Fields

Field	Details
DataType	Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Data type of the field that was changed.
Field	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The name of the field that was changed.
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
OpportunityId	Type reference Properties Filter, Group, Sort Description ID of the Opportunity. Label is Opportunity ID. This is a relationship field. Relationship Name Opportunity Relationship Type Lookup Refers To Opportunity
NewValue	Type anyType Properties Nillable, Sort Description The new value of the field that was changed.
OldValue	Type anyType Properties Nillable, Sort Description The latest value of the field before it was changed.

Usage

Use this object to identify changes to any fields on an Opportunity. The OpportunityHistory object represents the history of a change to the Amount, Probability, Stage, or Close Date fields of an Opportunity.

This object respects field level security on the parent object.

Object Reference for the Salesforce Platform

OpportunityFieldHistory

Supported Calls

Fields

Usage

See Also