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",
"errorMessage": 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; errorMessage 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).
Deprecated field: error is still sent next to errorMessage until it is removed on 2027-01-18. Read errorMessage.
Common errors
400 User must belong to an organizationwhen no organization can be derived from the session or token400 Invalid Export identifierwhen{exportId}is not shaped like a UUID401 Unauthorizedwhen you are not authenticated403 Forbiddenwhen you cannot read the organization404 Export not foundwhen the id does not belong to your organization