> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# run_saved_report

> Execute a saved report as configured and return the dataset the dashboard renders.

Runs the report with its stored attribution model, window, filters, sources, and group\_by — exactly as the dashboard would show it. Trust the user's saved config; for ad-hoc analysis with overrides, use [`query_ad_metrics`](/mcp/tools/query-ad-metrics) directly.

## Parameters

| Parameter   | Type    | Required | Description                         |
| ----------- | ------- | -------- | ----------------------------------- |
| `report_id` | integer | Yes      |                                     |
| `format`    | string  | No       | `json` (default), `csv`, or `yaml`. |

## Output

```json theme={null}
{
  "report_id": 42,
  "name": "ROAS by Source",
  "rows": [
    { "source": "facebook_ads", "roas": 3.82, "purchase": 412 },
    { "source": "google_ads",   "roas": 4.15, "purchase": 297 }
  ]
}
```

Custom event slot ids are rewritten to user labels in column names — `# label_map:` footer carries the mapping.

## Related

* [`get_report_definition`](/mcp/tools/get-report-definition) — inspect the report without running it.
* [`analyze_report`](/mcp/tools/analyze-report) — run the report AND get an AI-generated narrative summary (deducts AI credits).