Uptimeify Docs
Organization

List Data Exports

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

{
  "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

StatusMeaning
queuedAccepted, waiting for the builder
generatingThe bundle is being built
readyDownloadable until expiresAt
failedBuild failed; error carries the reason
expiredDownload 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

On this page