---
title: "List sent messages"
method: GET
path: "/sent-messages"
tags: ["sending"]
---

# List sent messages

`GET /sent-messages`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/sent-messages`
- Auth: HTTP bearer

Scoped to the workspace; supports enum filters for source/status/deliveryStatus, exact or fuzzy matching (per match) for recipient/sender/subject, q fuzzy search across fields (bodies excluded), and since/until to limit the send time.

## Query parameters

- `limit` string: Default 50, max 200
- `offset` string
- `source` string: Source: api, web, campaign, workflow, template_test, inbox_reply
- `status` string: Transport status: reserved, queued, sending, sent, skipped, failed
- `deliveryStatus` string: Delivery status: accepted, queued, sent, delivered, deferred, soft_bounced, hard_bounced, complained, unsubscribed, link_clicked
- `recipient` string: Recipient email; see match for the matching mode
- `sender` string: Sender email; see match for the matching mode
- `subject` string: Subject; see match for the matching mode
- `match` string: Matching mode for recipient/sender/subject: exact (default, case-insensitive full match) or fuzzy (contains)
- `since` string: Sent-at lower bound (inclusive): Unix seconds or ISO 8601; a date alone means UTC midnight
- `until` string: Sent-at upper bound (exclusive): Unix seconds or ISO 8601; a date alone means UTC midnight
- `campaignKey` string
- `taskId` string
- `providerMessageId` string
- `q` string: Fuzzy search across recipient, sender, subject, and message_id

## Response `200`

Message list

- object
  - `success` boolean, required
  - `messages` object[], required
  - `total` number, required
  - `limit` number, required
  - `offset` number, required
  - `hasMore` boolean, required

## Other responses

- `400`: Invalid enum filter or search parameters
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)