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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.