Search emails
Emails
Search emails
Plans: Free · Developer · Enterprise
Full-text / field search across mailbox messages. Returns { emails, totalCount }.
API credits: 1 (read).
GET
Search 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
Free-text query across subject, body, sender, recipients
Folder id filter
Sender contains
Recipient contains
Subject contains
ISO start date
ISO end date
true/1 for read only
true/1 for starred only
Category filter
Truthy to require attachments
page
limit