inbox

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

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.

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

Query parameters

address_idstring

Filter by inbox address

folderstring

inbox or quarantine, default inbox

limitstring

Default 20, max 100

cursorstring

Keyset pagination cursor

recipientstring

Recipient (to_address); see match for the matching mode

senderstring

Sender email; fuzzy matching also matches the display name

subjectstring

Subject; see match for the matching mode

matchstring

Matching mode for recipient/sender/subject: exact (default, case-insensitive full match) or fuzzy (contains)

qstring

Fuzzy search across recipient, sender, display name, and subject; does not search the body

sender_domainstring

Sender domain; case-insensitive exact domain match (subdomains excluded), uses an index

sincestring

Received-at lower bound (inclusive): Unix seconds or ISO 8601; a date alone means UTC midnight

untilstring

Received-at upper bound (exclusive): Unix seconds or ISO 8601; a date alone means UTC midnight

Response

Thread list

successboolean required
threadsobject[] required
cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.