---
title: "List message export jobs"
method: GET
path: "/v0/messages/export"
tags: ["Export"]
---

# List message export jobs

`GET /v0/messages/export`

## Request

- Base URL: `https://platform.sublime.security`
- URL: `https://platform.sublime.security/v0/messages/export`
- Auth: HTTP bearer

List message export jobs

## Query parameters

- `limit` integer, nullable: The maximum number of message export jobs to return.
- `offset` integer, nullable: The (zero-based) offset of the message export jobs to return
- `search` string, nullable: Search term to filter message export jobs

## Response `200`

OK

- HandlerTypesListMessageExportJobsResponseV0
  - `count` integer: Number of results returned
  - `jobs` HandlerTypesMessageExportJobV0[]
    - `auto_delete_in_seconds` integer, nullable: Seconds until the export is automatically deleted, counting down from when the job finished
    - `completed_at` string, date-time, nullable: Time the job finished successfully. Absent unless the job completed; see failed_at for unsuccessful runs.
    - `content_type` string, nullable: Format of the export file: EML, PDF, CSV, or JSON
    - `created_at` string, date-time, required: Time the export job was created
    - `created_by_user_id` string, uuid, required: ID of the user who started this export
    - `export_type` string, nullable: What the export covers, for example message-eml-export or dashboard-per-message
    - `failed_at` string, date-time, nullable: Time the job failed. Absent unless the job failed.
    - `failed_reason` string, nullable: Why the job failed, for example s3_error or max_retries_reached. Absent unless the job failed.
    - `file` TypesMessageExportJobFile: File for the message export results once job is completed
      - `expires_in` integer: Approximate duration of link in seconds
      - `name` string: Name of the export file
      - `url` string: URL to download the export file
    - `id` string, uuid, required: Unique ID of this export job. Use it to poll the job or to delete it.
    - `job_hash` string, required: Identifies the set of messages this export covers. A later request for the same set attaches to this job instead of starting a new one.
    - `task_progress` number, double, nullable: Percent complete, from 0 to 100. Absent until the export has started producing output.
    - `task_status` 'in_progress' | 'completed' | 'failed': Current status of the export
    - `updated_at` string, date-time, required: Time the job was last updated, including status and progress changes
  - `total` integer: Total number of results available

## Changes

- **2026-11-03** `081203bd7147`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sublime/apis/sublime-platform-api/changes/v0/messages/export/get.md)

---

[API](https://skmtc.dev/sublime/apis/sublime-platform-api.md) - [All operations](https://skmtc.dev/sublime/apis/sublime-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sublime/apis/sublime-platform-api/revisions/081203bd7147?raw)