---
title: "List Data Exports"
description: "Returns the recent data export requests of your organization with status, size, retention window and expiry."
---

`GET /api/organization/data-export`

Returns the 20 most recent export requests, newest first. Poll this (or
`GET /api/organization/data-export/{exportId}`) while an export is `queued` or
`generating`.

## Response

```json
{
  "exports": [
    {
      "id": "0f0f2f6a-2b3b-4a2f-9a7c-3e5f8c1d2b44",
      "status": "ready",
      "format": "json_csv",
      "includeCheckHistory": true,
      "recipientEmails": ["admin@youragency.com"],
      "sizeBytes": 18446721,
      "retentionCutoff": "2025-03-30T09:12:44.101Z",
      "expiresAt": "2026-08-06T09:19:02.884Z",
      "downloadCount": 1,
      "lastDownloadedAt": "2026-07-30T10:02:11.900Z",
      "error": null,
      "manifest": {
        "generatedAt": "2026-07-30T09:12:52.006Z",
        "retentionCutoff": "2025-03-30T09:12:44.101Z",
        "includeCheckHistory": true,
        "packages": [
          {
            "packageType": "fullservice",
            "displayName": "Full Service",
            "dataRetentionMonths": 16,
            "cutoff": "2025-03-30T09:12:44.101Z"
          }
        ],
        "sections": [
          { "path": "customers/customers", "rows": 42 },
          { "path": "monitors/websites", "rows": 311 },
          { "path": "checks/website-checks", "rows": 100000, "truncated": true }
        ],
        "redactedFields": ["passwords and passphrases", "webhook secrets and signing keys"]
      },
      "createdAt": "2026-07-30T09:12:44.101Z",
      "startedAt": "2026-07-30T09:12:45.010Z",
      "completedAt": "2026-07-30T09:19:02.884Z"
    }
  ],
  "cooldownHours": 6
}
```

## Statuses

| Status | Meaning |
| --- | --- |
| `queued` | Accepted, waiting for the builder |
| `generating` | The bundle is being built |
| `ready` | Downloadable until `expiresAt` |
| `failed` | Build failed; `error` carries the reason |
| `expired` | Download window closed, the file has been deleted |

## Single export

`GET /api/organization/data-export/{exportId}` returns one export in the same shape
(without the `exports` wrapper).

## Common errors

- `400 User must belong to an organization` when no organization can be derived from the session or token
- `401 Unauthorized` when you are not authenticated
- `403 Forbidden` when you cannot read the organization
- `404 Export not found` when the id does not belong to your organization