---
schema_version: "1"
id: b9c89d7aa86ab994c0f83733b36d35c36e24eb54132bf6d939b8ea7f1a1f211f
title: Get Dashboard Status
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/api_analytics/guides/examples/dashboards/analytics-api-dashboard-get-status.md
canonical_url: https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-get-status.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: b0e71427affde25002e1608499b7282e1ac809eacaa36ef91580fcbcbc6c3bf3
products:
  - Salesforce Reports and Dashboards REST API Developer Guide
  - analytics
---

# Get Dashboard Status

You can get the dashboard status by sending a GET request to the Dashboard Status resource.

Use the [Dashboard Status](https://developer.salesforce.com/docs/analytics/reference/dashboard/analytics-api-dashboard-status-resource.md) resource to retrieve a status for each component of the dashboard. The components are listed in the order in which they were refreshed. The request returns `IDLE` if a component is not currently being refreshed, and `RUNNING` if a component is currently being refreshed.

## Example Usage

To retrieve the status for a dashboard with an ID of 01ZD00000007QevMAE, you could make the following request:

```nolang
/services/data/v31.0/analytics/dashboards/01ZD00000007QevMAE/status
```

## Example Response Body

The response contains the status for each component, along with the refresh date and time:

```nolang
{
  "componentStatus" : [ {
    "componentId" : "01aD0000000J7M7",
    "refreshDate" : "2014-03-10T17:26:07.000+0000",
    "refreshStatus" : "IDLE"
  }, {
    "componentId" : "01aD0000000J7M9",
    "refreshDate" : "2014-03-10T17:26:08.000+0000",
    "refreshStatus" : "IDLE"
  }, {
    "componentId" : "01aD0000000J7MB",
    "refreshDate" : "2014-03-10T17:26:09.000+0000",
    "refreshStatus" : "IDLE"
  } ]
}
```

**See Also**  


-   [Dashboard Status](https://developer.salesforce.com/docs/analytics/reference/dashboard/analytics-api-dashboard-status-resource.md)