> ## 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.

# list_reports

> Saved reports across this space, optionally filtered to one dashboard.

## Parameters

| Parameter      | Type    | Required | Description                             |
| -------------- | ------- | -------- | --------------------------------------- |
| `dashboard_id` | integer | No       | Limit to reports inside this dashboard. |
| `format`       | string  | No       | `csv` (default), `json`, or `yaml`.     |

## Output

```csv theme={null}
id,name,dashboard_id,dashboard_name,report_type,metrics,sources,attribution_model
42,ROAS by Source,12,Weekly Performance,table,roas|purchase,facebook_ads|google_ads,last_touch
43,Daily Spend,12,Weekly Performance,line_chart,amount_spent,facebook_ads|google_ads,last_touch
```

`metrics` and `sources` are pipe-delimited inside the cell.