Emails

List emails

Requires mailbox read permission. Lists received email by default. To poll, list in ascending order, save pagination.next_cursor after every page (including an empty page) and send it next time with the same filters. Listing never marks email read.

get/v1/mailboxes/{mailbox_id}/emails

Request

  • Base URL: https://api.revdoku.com
  • URL: https://api.revdoku.com/v1/mailboxes/{mailbox_id}/emails
  • Auth: HTTP bearer

Path parameters

mailbox_idstring required

Query parameters

account_idstring

Select another granted account for this request. Omit to use the credential default. In JSON bodies, send account_id as a body field instead.

reasonstring nullable

Optional purpose for this action. AI agents should explain intentional reads and changes when known; omit when unknown. Do not include secrets, file contents, or transcripts.

limitinteger
cursorstring

pagination.next_cursor from the previous page.

order'asc' | 'desc'

Arrival order. Use asc to poll.

direction'received' | 'sent' | 'all'
senderstring

Exact sender address, case insensitive.

subjectstring

Case-insensitive subject text.

received_afterstring date-time
received_beforestring date-time
readboolean
has_attachmentsboolean
conversation_idstring

Return the emails of this conversation.

include_storageboolean

Include backing file IDs for file-browser integrations.

Response

Success

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.