List emails
Emails
List emails
Plans: Free · Developer · Enterprise
Lists emails in a mailbox. When folder or is_starred is set, the response is { emails, totalCount }; otherwise a bare array may be returned.
API credits: 1 (read).
GET
List emails
Authorizations
API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.
Path Parameters
Mailbox public_id (UUID), hosted alias id, or current email
Query Parameters
Folder id
Filter by thread id
Email category
Available options:
customer_support, technical, partnership, other Custom label slug
true/1 or false/0
true/1 or false/0
Set to true/1 to aggregate by thread
Page number (≥1)
Required range:
x >= 1Page size (1–100, default 25)
Required range:
1 <= x <= 100Sort column
Available options:
id, subject, sender, recipient, date, read, starred ASC for ascending; otherwise descending