---
title: "List recent exports"
method: GET
path: "/v1/exports"
tags: ["Exports"]
---

# List recent exports

`GET /v1/exports`

## Request

- Base URL: `https://api.slashy.com`
- URL: `https://api.slashy.com/v1/exports`
- Auth: HTTP bearer

The team's 20 most recent exports this key can see, newest first, without download links.

**Scope:** `mail.metadata.read`. **Rate limit class:** `read` (600/minute per key).

## Response `200`

OK

- ExportList
  - `exports` Export[], required: Newest first, up to 20, without `files`.
    - `id` string, uuid, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `expires_at` string, date-time, nullable, required: When the files are deleted (7 days after the export started); set once it succeeds.
    - `inbox_ids` string[], required: The exported inboxes this key can read.
    - `since` string, date-time, nullable, required
    - `include_content` boolean, required: Whether the files have the `mail.content.read` columns. Downloading them needs that scope.
    - `row_count` integer, nullable, required: Messages across the files this key can read; set once it succeeds.
    - `error` string, nullable, required: Why the export failed.
    - `files` ExportFile[]: One Parquet file per inbox, once the export succeeds. Only on `GET /v1/exports/{id}`.
      - `inbox_id` string, uuid, required
      - `rows` integer, required: Messages in the file.
      - `bytes` integer, required
      - `url` string, uri, nullable, required: Presigned download link. `null` once the files are deleted (after `expires_at`).
      - `url_expires_at` string, date-time, nullable, required: The link stops working at this time, at most an hour after this request. GET the export again for a fresh link.

## Other responses

- `401`: Missing, malformed, unknown, revoked or expired API key. `error` is one of: `invalid_api_key`, `api_key_revoked`, `api_key_expired`.
- `403`: The key is valid but may not make this call. `error` is one of: `browser_not_allowed`, `ip_not_allowed`, `not_enterprise`, `key_owner_inactive`, `insufficient_scope`.
- `429`: Too many requests. Wait `Retry-After` seconds, then retry. `error` is one of: `too_many_auth_failures`, `rate_limited`, `too_many_concurrent_requests`.

---

[API](https://skmtc.dev/slashy/apis/slashy-enterprise-api.md) - [All operations](https://skmtc.dev/slashy/apis/slashy-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slashy/apis/slashy-enterprise-api/revisions/49841c75ad9f?raw)