# The Report Run object

### The Report Run object

```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
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- `created` (timestamp)
  Time at which the object was created. Measured in seconds since the Unix epoch.

- `error` (string, nullable)
  If something should go wrong during the run, a message about the failure (populated when `status=failed`).

- `livemode` (boolean)
  `true` if the report is run on live mode data and `false` if it is run on test mode data.

- [`parameters`](https://docs.stripe.com/api/reporting/report_run/object.md?query=parameters) (object)
  Parameters of this report run.

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

- [`result`](https://docs.stripe.com/api/reporting/report_run/object.md?query=result) (object, nullable)
  The file object representing the result of the report run (populated when `status=succeeded`).

- `status` (string)
  Status of this report run. This will be `pending` when the run is initially created. When the run finishes, this will be set to `succeeded` and the `result` field will be populated. Rarely, we may encounter an error, at which point this will be set to `failed` and the `error` field will be populated.

- `succeeded_at` (timestamp, nullable)
  Timestamp at which this run successfully finished (populated when `status=succeeded`). Measured in seconds since the Unix epoch.
