---
schema_version: "1"
id: 49aef13d33130667653bb16dd1891aa4b350bb1f74ca406a525fb934d86fc8b4
title: View the Action History
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/salesforce_guided_engagement/guides/guided-engagement-access-history.md
canonical_url: https://developer.salesforce.com/docs/service/salesforce-guided-engagement/guide/guided-engagement-access-history.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 01330e7ae40866a3c4a778cac02a50efc880c2b94902a690107d8a225931383d
products:
  - Lightning Flow for Service Developer Guide
  - Service Cloud Developer Content
---

# View the Action History

See which actions were launched, by which agents, and when in the History tab on the Actions & Recommendations component. The History tab also shows the state, or status, for each action, so you can see when an action was started, paused, resumed, and completed. You also can access the action history for a record programmatically using the RecordActionHistory object.

| Required Editions                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Available in: Lightning Experience                                                                                                                                                                                                                                                                                                                  |
| Available in: **Essentials**, **Professional**, **Enterprise**, **Performance**, **Unlimited**, and **Developer** Editions<br>Lightning console apps are available for an extra cost to users with Salesforce Platform user licenses for certain products. Some restrictions apply. For pricing details, contact your Salesforce account executive. |

## Use the Component’s History to Understand Status

The History tab lists state changes for actions associated with the record. It helps agents and supervisors grasp status so that they can quickly decide what to do next. For example, in a handoff or escalation, an agent or supervisor can review the history to identify gaps and determine the next step.

Here’s an example. The History tab lists the most recent 20 state changes, sorted with the most recently logged events listed first. Click **View More** to see the next 20 state changes in the log. Users can filter the list to see actions by status. The filter only applies to the last 200 actions.

![The component shows the history of guided actions.](https://developer.salesforce.com/docs/media/guided_engagement_history_224.png)

## Use APIs to Query the Action History

You can also use APIs to query the RecordActionHistory object, which is a big object.

**note:** The RecordActionHistory object is read-only. It is available in API version 44.0 and later.

Both synchronous and asynchronous queries are supported. Using SOQL, SOAP, REST, Bulk, or Apex APIs, synchronous queries must follow a specific pattern or they fail. See the description and examples in the [Object Reference for Salesforce and Lightning Platform](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_recordactionhistory.htm). To learn more about big objects and how to query them, see the _[Query Big Objects](https://trailhead.salesforce.com/en/modules/big_objects/units/big_objects_querying)_ module on Trailhead.

If you have access to Analytics, you can query the RecordActionHistory object and use the data to build an Analytics dashboard. For example, the dashboard can show usage data and compare how many actions were started, paused, resumed, and completed in a given time period.

![You can display an Analytics dashboard with RecordActionHistory data.](https://developer.salesforce.com/docs/media/guided_engagement_guided_action_history_analytics.png)