# The Report Run object

### The Report Run object

```json
{
  "id": "rrun_61VWgxrbW8zNyPllt16Nsp4WJSSQIjR7nKfqrPPQWOsK",
  "object": "v2.data.report_run",
  "created": "2026-10-05T21:01:11.504756927Z",
  "livemode": true,
  "name": "balance.summary",
  "parameters": {
    "interval_end": "2026-07-01T00:00:00.000Z",
    "interval_start": "2026-06-01T00:00:00.000Z"
  },
  "refreshed_at": "2026-10-07T21:01:11.000Z",
  "report": "report_61Sud3n5oAGVCWiSr5",
  "result": {
    "col_count": "4",
    "file": {
      "columns": [
        {
          "name": "category",
          "type": "varchar"
        },
        {
          "name": "description",
          "type": "varchar"
        },
        {
          "name": "net_amount",
          "type": "decimal"
        },
        {
          "name": "currency",
          "type": "varchar"
        }
      ],
      "content_type": "csv",
      "download_url": {
        "expires_at": "2026-10-05T21:12:08.978477350Z",
        "url": "https://stripeusercontent.com/files/us-west-2/..."
      },
      "size": "2121"
    },
    "row_count": "32"
  },
  "result_options": {
    "compression": "none"
  },
  "sql": null,
  "status": "succeeded",
  "status_details": null
}
```

## Attributes

- `id` (string)
  The unique identifier of the `ReportRun`.

- `object` (string, value is "v2.data.report_run")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  Time at which the `ReportRun` was created.

- `format` (enum)
  The file format of the result.
Possible enum values:
  - `csv`
    CSV format.

- `livemode` (boolean)
  Whether the `ReportRun` was executed in live mode.

- `name` (string)
  The human-readable name of the `Report` which was run.

- `parameters` (map)
  The parameters used to customize the generation of the report.

- `refreshed_at` (timestamp, nullable)
  Time at which the data used by this report was last refreshed.

- `report` (string)
  The unique identifier of the `Report` which was run.

- [`result`](https://docs.stripe.com/api/v2/data/report-runs/object.md?query=result) (object, nullable)
  The result of the `ReportRun`, populated when it has completed.

- [`result_options`](https://docs.stripe.com/api/v2/data/report-runs/object.md?query=result_options) (object, nullable)
  Settings applied to the generated result file.

- `sql` (string, nullable)
  The fully-resolved SQL that was executed, or an explanatory message when the SQL cannot be exposed. Only present when requested via `include[0]=sql`.

- `status` (enum)
  The current status of the `ReportRun`.
Possible enum values:
  - `canceled`
    The run was canceled.

  - `failed`
    The run has failed.

  - `running`
    The run is currently in progress.

  - `succeeded`
    The run has completed successfully.

- [`status_details`](https://docs.stripe.com/api/v2/data/report-runs/object.md?query=status_details) (object, nullable)
  Additional details about the current state of the `ReportRun`.