---
title: "List threads (each with a summary of its latest email)"
method: GET
path: "/inbox/threads"
tags: ["inbox"]
---

# List threads (each with a summary of its latest email)

`GET /inbox/threads`

## 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/inbox/threads`
- Auth: HTTP bearer

Keyset pagination; cursor is `${last_received_at}|${thread_id}`. Search parameters match the email list; a thread is returned when any email in it satisfies all conditions.

## Query parameters

- `address_id` string: Filter by inbox address
- `folder` string: inbox or quarantine, default inbox
- `limit` string: Default 20, max 100
- `cursor` string: Keyset pagination cursor
- `recipient` string: Recipient (to_address); see match for the matching mode
- `sender` string: Sender email; fuzzy matching also matches the display name
- `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)
- `q` string: Fuzzy search across recipient, sender, display name, and subject; does not search the body
- `sender_domain` string: Sender domain; case-insensitive exact domain match (subdomains excluded), uses an index
- `since` string: Received-at lower bound (inclusive): Unix seconds or ISO 8601; a date alone means UTC midnight
- `until` string: Received-at upper bound (exclusive): Unix seconds or ISO 8601; a date alone means UTC midnight

## Response `200`

Thread list

- object
  - `success` boolean, required
  - `threads` object[], required
  - `cursor` string, nullable, required

## Other responses

- `400`: Invalid folder, cursor, or search parameters
- `401`: Missing or invalid API key
- `500`: Lookup failed

---

[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)