---
title: "List the exports"
description: "Every export of the workspace, newest first."
url: "https://openemail.uk/docs/api/exports/list"
area: "API"
category: "Mailbox"
---

# List the exports

Every export of the workspace, newest first.

`GET /exports`

## GET /exports

Every export of the workspace, newest first.

## Example

Needs `threads:read`. `limit` and `offset` page through them, and `total` counts them all.

**curl**

```
curl "$OE/exports?limit=10" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "export",
      "id": "exp_8c1e4a7f2b9d3e6a0c5f1b28",
      "status": "ready",
      "phase": null,
      "createdAt": "2026-09-30T09:12:44.000Z",
      "createdBy": { "name": "Ana Lima", "email": "ana@acme.com" },
      "startedAt": "2026-09-30T09:12:46.000Z",
      "finishedAt": "2026-09-30T09:31:02.000Z",
      "expiresAt": "2027-09-30T09:31:02.000Z",
      "sizeBytes": 1840233472,
      "fileName": "acme_20260930_093102.zip",
      "threadsDone": 18420,
      "threadsTotal": 18420,
      "error": null
    }],
  "total": 1,
  "hasMore": false
}
```

> Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an app connected with every address. A key or an app limited to particular addresses or domains is a 422 `capability_unsupported`.

## Reference

- [`GET /exports`](https://openemail.uk/docs/api/reference/exports#get-exports): full reference