---
module: reports.runs
title: Run History
tab: Customer
order: 10
audience: customer
---

Every time a report is generated — whether you run it by hand or it runs on a schedule — it shows up here. Use **Run History** to check whether a report finished, preview the results, and download the file.

## 📋 What you're looking at

Each row is one report run, with these details:

- **Report** — the file name of the generated report (based on the report name and the date it ran).
- **Status** — where the run is in its lifecycle:
  - **PENDING** — queued, waiting to start
  - **RUNNING** — currently being generated
  - **COMPLETED** — finished and ready to view or download
  - **FAILED** — something went wrong; hover the **⚠ Failed** marker to see why
- **Rows** — how many rows of data the report produced.
- **Triggered By** — who started it: a user's email address, or **Scheduled** if it ran automatically.
- **Started / Completed** — when the run began and finished.

## ✅ What you can do here

1. **Preview** — on a completed run, click **Preview** to see the first 50 rows right in the browser, without downloading anything.
2. **Download** — click **Download** to save the finished report to your computer (CSV or JSON, depending on the report).
3. **Delete** — remove a run you no longer need. You'll be asked to confirm first.

> To start a new report run, go to the **Templates** tab and click **▶ Run** on the report you want.

## 🕐 Good to know

- The list refreshes on its own about every minute. Use the **Auto-refresh** toggle at the top right to turn this off or on — handy for watching a **RUNNING** report finish.
- **Preview** and **Download** only appear once a run reaches **COMPLETED**.
- A **FAILED** run can be deleted and re-run from the Templates tab.
