# Filter Dashboard Results

You can filter dashboard results, status, or refresh requests, by using filter parameters.

Dashboard results are always unfiltered, unless you have specified filter parameters in your request. When requesting a dashboard result, status, or refresh, you can specify up to three optional filter parameters: filter1, filter2 and filter3. These parameters allow you to apply filter options, which can be selected from the filters that are currently defined for the dashboard. Filters can be applied to the following requests:

- A GET request on the [Dashboard Results](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-results-resource.md) resource: returns data filtered by the specified parameters.
- A PUT request on the [Dashboard Results](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-results-resource.md) resource: refreshes the data that has been filtered by the specified parameters.
- A GET request on the [Dashboard Status](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-status-resource.md) resource: returns status for the data that has been filtered by the specified parameters.

## Example Usage

A dashboard with one filter ("Country") and two options ("United States" and "Canada") appears like this in the dashboard metadata:

```nolang
{
  "dashboardMetadata" : {
    ...

    "filters" : [ {
        "name" : "Country",
        "options" : [ {
            "id" : "0ICxx0000000001GAA",
            "alias" : "United States",
            "operation" : "equals",
            "value" : "US",
            "startValue" : null,
            "endValue" : null
         } ], [ {
            "id" : "0ICxx0000000002GAA",
            "alias" : "Canada",
            "operation" : "equals",
            "value" : "CA",
            "startValue" : null,
            "endValue" : null
         } ],

    ...
}
```

To retrieve dashboard results with a filter of "Country equals Canada" you could make the following GET request:

```nolang
/services/data/v31.0/analytics/dashboards/01Zxx0000000000000?filter1=0ICxx0000000002GAA
```

**See Also**

- [Dashboard Results](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-results-resource.md)
- [Dashboard Status](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-status-resource.md)