List the organization's exports
The organizations.exports.list operation: GET /api/v1/organizations/{id}/exports in the REST API and the organizations_exports_list tool in the MCP server.
GET
/api/v1/organizations/{id}/exportsLists the organization's data exports, newest first (at most 20): queued, running, ready with the archive
(downloadable from the console for 7 days, then expired) or failed with the reason.
At a glance
- REST:
GET /api/v1/organizations/{id}/exports - MCP tool:
organizations_exports_list - Operation ID:
organizations.exports.list - Scope: Organization
- Permission:
org:admin - Risk tier:
read - Dry run: Not supported
- Idempotency: Not needed (read only)
- Modes: Test and live
- Authentication: API key with the
org:adminscope - Since: M12
Request
Path parameters
| Field | Type | Description |
|---|---|---|
id | org_… ID |
Query parameters
This operation takes no query parameters.
Response
200 OK with a JSON object:
| Field | Type | Description |
|---|---|---|
object | "list" | |
data | array of object | |
data[].id | exp_… ID | |
data[].object | "organization_export" | |
data[].status | one of queued, running, ready, expired, failed | queued, running, then ready (downloadable for 7 days, then expired) or failed. |
data[].requestedBy | object | |
data[].requestedBy.type | string | |
data[].requestedBy.id | string | |
data[].file | object or null | |
data[].failure | object or null | |
data[].readyAt | date-time or null | |
data[].expiresAt | date-time or null | |
data[].createdAt | date-time | |
data[].updatedAt | date-time |
Examples
A ready export
HTTP
GET /api/v1/organizations/org_01m4tx5nj7ekd958x53w4bntcg/exports
Authorization: Bearer or_test_…
Response (200):
JSON
{
"object": "list",
"data": [
{
"id": "exp_01m4tx5nj8emwbyf7y9vcf47xf",
"object": "organization_export",
"status": "ready",
"requestedBy": {
"type": "user",
"id": "usr_01m4tx5nj8emwbyf7y9vcf47xa"
},
"file": {
"fileId": "file_01m4tx5nj8emwbyf7y9vcf47xg",
"filename": "ownrecord-export-2026-10-26.zip",
"contentType": "application/zip",
"size": 482113,
"sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"documents": 1204
},
"failure": null,
"readyAt": "2026-10-26T09:00:00.000Z",
"expiresAt": "2026-11-02T09:00:00.000Z",
"createdAt": "2026-10-26T09:00:00.000Z",
"updatedAt": "2026-10-26T09:00:00.000Z"
}
]
}
Errors
| Code | HTTP status | When | What to do |
|---|---|---|---|
resource_not_found | 404 | The ID isn't the organization of the request. | Check the ID and that your credentials are scoped to the right organization, entity, brand and mode. |
permission_denied | 403 | You can't export this organization. | Ask an organization owner or admin for a role or scope that allows this action. |
It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, dry_run_not_supported, rate_limited, internal_error.