List raw view exports

This endpoint returns the daily exports of your raw view data. Each export covers one full UTC day and contains every view that completed on that date, with a time-limited URL to download it as a CSV file. Exports are generated once a day by a scheduled job and are retained for **7 days**, after which the file is deleted and no longer returned. Only dates on or after the day your workspace enabled exports are available; earlier dates are never backfilled. #### Enabling exports Exports are not generated until your workspace enables them, and the **first request to this endpoint performs that enablement**. That request checks your organization's plan, records the decision, and returns an empty list together with a `message` naming the date your first file will cover. Exports are available on paid plans. If your organization is not eligible the first request fails with **403**, and nothing is enabled. Only that first request can fail that way — once enabled, listing and downloading are never plan-checked again, and a workspace that later downgrades keeps access to files it has already generated until they expire. Your first file is produced by the next scheduled run, and covers the whole UTC day on which you enabled exports, including views that completed earlier that day. #### Key fields in response * **timeFrame:** The effective query window, as unix epoch timestamps. * **totalRowCount:** The number of export records returned. * **message:** Present only on the request that enabled exports, confirming the date of your first file. * **exportDate:** The UTC date the export covers. * **status:** The state of the export. `COMPLETED` for a day with views, `EMPTY` for a day with none. * **files:** The files for this export. Each export produces a single file, returned as a one-item array. * **downloadUrl:** A time-limited URL that downloads the export as `views_{date}.csv`. * **downloadUrlExpiresAt:** When the download URL stops working. This matches the moment the file itself is deleted. * **rowCount:** The number of data rows in the file, excluding the header row. * **version:** The CSV format version. #### Downloading The download gives you a plain CSV file, saved as `views_{date}.csv`. Browsers and most HTTP clients — including Python `requests`, `httpx` and JavaScript `fetch` — handle it automatically, so you can open or parse it directly. The file is compressed in transit to save bandwidth. Clients that do not request compression, such as `curl`, `wget` and Java's `HttpClient`, receive those compressed bytes instead of the CSV. With `curl`, ask for decompression explicitly: ``` curl --compressed -o views_2026-08-16.csv "<downloadUrl>" ``` Exports can be large — a busy day of roughly 200,000 views produces several hundred megabytes of CSV. Stream the file to disk and parse it row by row rather than loading it into memory, and use a database or data warehouse rather than a spreadsheet on high-volume days. #### Notes for consumers * A day with no views returns `EMPTY` with `rowCount` of 0 and a valid file containing only the header row. This is a success, not an error, and needs no special handling or retry. * Parse the CSV by column name, never by column position. New columns are appended over time. * If you download the same date more than once, replace that date's rows rather than appending them. * Do not store or share download URLs. Each one grants direct access to your view data and stays valid until the file itself expires.