Mail

Search messages

Search by general query or advanced filters (from, subject, body, date range). Requires scope mail:read.

get/mailboxes/{address}/search

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/mailboxes/{address}/search
  • Auth: HTTP bearer

Path parameters

addressstring required

Full mailbox address, e.g. user@yourdomain.com

Query parameters

folderstring

IMAP folder name (defaults to INBOX)

qstring

General search query (searches all fields)

fromstring

Filter by sender address

subjectstring

Filter by subject line

bodystring

Filter by body content

dateAfterstring date

Messages after this date (inclusive)

dateBeforestring date

Messages before this date (inclusive)

Response

Search results

successboolean

Example response

{
  "success": true,
  "data": {
    "messages": [
      {
        "uid": 1234,
        "from": "alice@example.com"
      }
    ]
  }
}

Changes

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