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

# List Data Exports

> List the buckets Sequenzy streams your data to

Returns every data export in the workspace with its status, how far each dataset has been exported, and the last error. Credentials are never returned; `accessKeyId` is masked.

Requires the `data_exports:read` scope. Marketers cannot use data export routes.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/data-exports" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

<ResponseField name="dataExports" type="object[]">
  <Expandable title="data export">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="provider" type="string">
      `s3` or `gcs`.
    </ResponseField>

    <ResponseField name="bucket" type="string" />

    <ResponseField name="region" type="string">
      `auto` for GCS and custom endpoints without a region.
    </ResponseField>

    <ResponseField name="endpoint" type="string | null">
      Custom S3-compatible endpoint, or `null`.
    </ResponseField>

    <ResponseField name="pathPrefix" type="string">
      Folder inside the bucket, without leading or trailing slashes.
    </ResponseField>

    <ResponseField name="accessKeyId" type="string">
      Masked, for example `AKIA…WXYZ`.
    </ResponseField>

    <ResponseField name="datasets" type="string[]">
      Any of `email_events`, `sms_events`, `custom_events`, `subscribers`.
    </ResponseField>

    <ResponseField name="frequency" type="string">
      `every_5_minutes`, `every_15_minutes`, `hourly` or `daily`.
    </ResponseField>

    <ResponseField name="isEnabled" type="boolean">
      `false` while paused.
    </ResponseField>

    <ResponseField name="status" type="string">
      `idle`, `queued`, `running`, or `failed` (the last run failed and a retry
      is scheduled).
    </ResponseField>

    <ResponseField name="exportedThrough" type="object">
      Per dataset. Event datasets: everything recorded up to this timestamp has
      been written. `subscribers`: date of the last complete snapshot. `null`
      before the first export.
    </ResponseField>

    <ResponseField name="nextRunAt" type="string | null" />

    <ResponseField name="lastRunAt" type="string | null" />

    <ResponseField name="lastSuccessAt" type="string | null" />

    <ResponseField name="lastError" type="string | null">
      Readable reason for the last failure, cleared after a successful run.
    </ResponseField>

    <ResponseField name="consecutiveFailures" type="integer">
      Retries back off exponentially from the export frequency, up to 6 hours.
    </ResponseField>

    <ResponseField name="totalRowsExported" type="integer" />
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "dataExports": [
      {
        "id": "exp_abc123",
        "name": "Analytics lake",
        "provider": "s3",
        "bucket": "acme-exports",
        "region": "us-east-1",
        "endpoint": null,
        "pathPrefix": "sequenzy",
        "accessKeyId": "AKIA…WXYZ",
        "datasets": ["email_events", "custom_events", "subscribers"],
        "frequency": "every_15_minutes",
        "isEnabled": true,
        "status": "idle",
        "startFrom": "2026-09-30T09:00:00.000Z",
        "exportedThrough": {
          "email_events": "2026-09-30T11:58:00.000Z",
          "custom_events": "2026-09-30T11:58:00.000Z",
          "subscribers": "2026-09-30"
        },
        "nextRunAt": "2026-09-30T12:13:00.000Z",
        "lastRunAt": "2026-09-30T11:58:00.000Z",
        "lastSuccessAt": "2026-09-30T12:00:04.000Z",
        "lastError": null,
        "lastErrorAt": null,
        "consecutiveFailures": 0,
        "totalRowsExported": 184233,
        "createdAt": "2026-09-30T09:00:00.000Z",
        "updatedAt": "2026-09-30T12:00:04.000Z"
      }
    ]
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": "API key is missing required scope: data_exports:read"
  }
  ```
</ResponseExample>


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