# Create a Report Run

Creates a new object and begin running the report. (Certain report types require a [live-mode API key](https://docs.stripe.com/keys.md#test-live-modes).)

## Request

```curl
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "<<YOUR_SECRET_KEY>>" \
  -d "report_type=balance.summary.1" \
  -d "parameters[interval_start]=1680000000" \
  -d "parameters[interval_end]=1680100000"
```

### Response

```json
{
  "id": "frr_1MrQwrLkdIwHu7ixUov4x2b3",
  "object": "reporting.report_run",
  "created": 1680203749,
  "error": null,
  "livemode": false,
  "parameters": {
    "interval_end": 1680100000,
    "interval_start": 1680000000
  },
  "report_type": "balance.summary.1",
  "result": null,
  "status": "pending",
  "succeeded_at": null
}
```

## Returns

Returns the new `ReportRun` object.

## Parameters

- `report_type` (string, required)
  The ID of the [report type](https://docs.stripe.com/docs/reporting/statements/api.md#report-types) to run, such as `"balance.summary.1"`.

- [`parameters`](https://docs.stripe.com/api/reporting/report_run/create.md?query=parameters) (object, optional)
  Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the [API Access to Reports](https://docs.stripe.com/docs/reporting/statements/api.md) documentation.