Mailly文档

List received emails (without bodies)

GET
/inbox/messages

Keyset pagination; cursor is ${received_at}|${id}. Supports recipient/sender/subject (match=exact|fuzzy), sender_domain, q fuzzy search, and a since/until received-at range; does not search bodies.

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

Email list

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