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

# get_report_definition

> Full saved-report config — metrics, filters, attribution, group_by, sources, options.

Returns the report's raw row from `custom_reports` — useful for explaining what a saved report measures without executing it.

## Parameters

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

## Output

Full JSON object containing every column of the report row, including `date_range`, `attribution_model`, `attribution_window`, `metrics`, `sources`, `filters`, `options`, `group_by`, etc.

For execution, use [`run_saved_report`](/mcp/tools/run-saved-report). For the AI-summarized narrative, use [`analyze_report`](/mcp/tools/analyze-report).