# Analytics Download

Download a `.png` image of a CRM Analytics dashboard or lens, or Lightning Experience dashboard or report. Download a `.pdf` file of a CRM Analytics dashboard or lens. Request downloads via browser calls.

## Syntax

**URI:** `domain/analytics/download/assetType/assetId.downloadType`

:::note
To request a download, enter the URI in a browser address bar.

We don't support the use of this API from Apex.
:::

**Formats:** `.png` or `.pdf`

**Parameters**

| Parameter      | Description                                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `assetType`    | Required. Specifies what type of Analytics asset to download. Valid values are:<ul><li>`dashboard`</li><li>`lens`</li><li>`lightning-dashboard`</li><li>`report`</li></ul> |
| `assetId`      | Required. Specifies the Analytics asset id to download.                                                                                                                    |
| `downloadType` | Required. Specifies what file type to download the Analytics asset as. Valid values are:<ul><li>`png`</li><li>`pdf`</li></ul>                                              |

:::note
For Lightning Experience reports, the request works only with `png` and only if the report has a chart. If you use `pdf` or if the report doesn’t have a chart, the request returns an error.
:::

**Query Parameters**

| Parameter     | Description                                                                                                                      |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `includeData` | Optional. Indicates whether to include that tabular widget data (`true`) or not(`false`).                                        |
| `pageId`      | Optional. Specifies the Id for a dashboard page to download.                                                                     |
| `pageSize`    | Optional. Specifies page size to download. Valid values are:<ul><li>`A3`</li><li>`A4`</li><li>`LEGAL`</li><li>`LETTER`</li></ul> |
| `savedviewId` | Optional. Specifies the Id for a dashboard saved view to download.                                                               |

:::note
For Lightning Experience reports, the request works only with `png` and only if the report has a chart. If you use `pdf` or if the report doesn’t have a chart, the request returns an error.
:::

## Response Body

The response body is binary data of the `.png` or `.pdf` representation of the Analytics asset.

For limits on columns and pages in `.pdf` files, see [Analytics Download Limits](https://help.salesforce.com/apex/HTViewHelpDoc?id=bi_limits.htm\&language=en_US#AnalyticsDownloadLimits).
