> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# analyticsReportExportStart

> Write every row of a READY report to a CSV in the background. Returns the export while it is RUNNING; poll `analyticsReportExport` for the download link. The file is kept for 24 hours after the export starts. Null when the report does not exist. Throws REPORT_NOT_READY (409) until the report is READY.

**Required scopes:** [`analytics_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-analytics_read)

## Arguments

**reportId** `ID!` *required*

The id of the report to export.

**timezone** `String`

An IANA timezone to run the report in instead of its own.

## Returns

**analyticsReportExportStart**

A CSV of every row of an analytics report, written in the background and kept for 24 hours after the export starts. Use it for more rows than `analyticsReportRows` should page.

**fields**

**createdAt** *required*

When the export started.

**downloadExpiresAt**

When `downloadUrl` stops working.

**downloadUrl** `String`

A short-lived link to download the CSV. Fetch the export again for a fresh link once it expires, until the export expires 24 hours after it starts.

**error** `String`

Why the export FAILED.

**id** `ID!` *required*

The export's id, for `analyticsReportExport`.

**rowCount** `Int`

How many rows the file has, once it is ready.

**status** *required*

Whether the file is ready.

## Example

```graphql theme={null}
mutation {
  analyticsReportExportStart(reportId: "...", timezone: "...") {
    createdAt
    downloadExpiresAt
    downloadUrl
    error
    id
    rowCount
    status
  }
}
```


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