---
title: "GET /v1/exports"
method: GET
path: "/v1/exports"
---

# GET /v1/exports

`GET /v1/exports`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-better-auth.session_token`

The organisation's recent exports, newest first.

## Response `200`

The request has succeeded.

- ExportList
  - `exports` Export[], required: The organisation's last five exports, newest first.
    - `id` string, required
    - `state` 'running' | 'ready' | 'failed', required
    - `startedAt` string, date-time, required
    - `finishedAt` string, date-time, nullable, required
    - `messages` integer, nullable, required: Messages written. Null until it is ready.
    - `missing` integer, nullable, required: Messages left out because their original is gone. Null until it is ready.
    - `files` ExportFile[], required: Empty until it is ready, and again once its files have expired.
      - `name` string, required: `organisation.json`, or `<mailbox>.mbox`.
      - `bytes` integer, required
      - `url` string, uri, required: ⚠️ The link IS the authority to download it. It is shown to the caller and never mailed.
      - `expiresAt` string, date-time, required: When the file, and so the link, goes — seven days after it was written.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/org.md) - [All operations](https://skmtc.dev/foundermail/apis/org/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/org/revisions/8bbb36e378ab?raw)