agenda

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.

get/v2/agenda/email/messages

Query parameters

limitinteger
searchQuerystring
folder'inbox' | 'all'
cursorstring
startstring date-time
endstring date-time

Response

Successful response

Changes

Changed in 3 of the 21 revisions of this API.14

    • for the query request parameter limit, the max was decreased from 9007199254740991.00 to 100.00

      request-parameter-max-decreased

    • added the new optional query request parameter cursor

      new-optional-request-parameter

    • added the new optional query request parameter folder

      new-optional-request-parameter

    • api operation id listEmailMessagesV2 was added

      api-operation-id-added

    • endpoint added

      endpoint-added