Search or list emails (v2)
Email search and listing across ALL of the authenticated user's connected mail accounts, fetched live from the providers (Google / Microsoft) — Dex stores no message content. Omit searchQuery to list newest-first; pass it to match subject, body, and participants as plain text (provider search operators are neutralized). folder=inbox restricts to received mail (the default spans the whole mailbox, including sent). Optional limit (default 25) and dateRange.{start,end} scope the window, defaulting to roughly the last 6 months; cursor (the previous response's pagination.nextCursor) continues a listing. Returns { data: { email_messages, pagination } } with sender, participants, subject, snippet, and a provider deep link per message.
Query parameters
Response
Successful response
Changes
Changed in 3 of the 21 revisions of this API.14
- ▲
for the
queryrequest parameterlimit, the max was decreased from9007199254740991.00to100.00request-parameter-max-decreased
- ○
added the new optional
queryrequest parametercursornew-optional-request-parameter
- ○
added the new optional
queryrequest parameterfoldernew-optional-request-parameter
- ▲
- ○
api operation id
listEmailMessagesV2was addedapi-operation-id-added
- ○
- ○
endpoint added
endpoint-added
- ○