MaillyDocs

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

GET
/inbox/threads

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.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Mailly API key(Authorization: Bearer )

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 Body

Thread list

application/json
  1. response
success*boolean
threads*array<>
cursor*string|null
[key: string]?unknown
curl -X GET 'https://api.mailly.site/inbox/threads'
{  "success": true,  "threads": [    {      "property1": null,      "property2": null    }  ],  "cursor": "string",  "property1": null,  "property2": null}