> ## 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`](https://docs.cometly.com/mcp/tools/run-saved-report). For the AI-summarized narrative, use [`analyze_report`](https://docs.cometly.com/mcp/tools/analyze-report).


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