MAmailsac
Messages

List messages for an email inbox

Changed on

Get a list of messages for the email address. Messages are always sorted in decending order by when they were received, with the newest message always in the first position of the array.

The email message objects are abbreviated to provide basic meta data. To get more information about a specific message, use GET /api/addresses/{email}/messages/{messageId}.

It is NOT necessary to reserve the address before checking mail! Whether it is an address on a custom domain, or a public domain, or mailsac.com, the mail can be checked with this route.

get/addresses/{email}/messages

Request

  • Base URL
    https://mailsac.com/api
  • Auth
    • API key in query parameter _mailsacKey
    • or API key in header Mailsac-Key

Response

Email messages

_idstring string

Unique Mailsac-generated identifier for an email message

subjectstring

Email subject header line. Can be an empty string.

savedBystring

Indicates a starred message by your account Account._id. Otherwise null.

originalInboxstring

Same as inbox unless sent to the encryptedInbox, in which case it would be the encryptedInbox.

inboxstring email

Email address to which this message belongs.

domainstring domain

hostname domain for the inbox

receivedstring date

Date in ISO 8601

sizenumber

Content length in bytes of the original raw email message

attachmentsMd5sum[]

null or array of MD5 hashes of attachments. Use the Attachments API to get metadata and download attachments.

ipstring

The remote SMTP server that send the mail to the server at via

viastring

IP address of SMTP server that received the message from ip

folder'inbox' | 'all' | 'spam' | 'trash'

Inbox folder that this message has been put into

labelsstring[]

Custom inbox labels created by the end user

readboolean

Read/uread status. true=read, false=unread. Only set from the Inbox UI app.

rtlsboolean

When true, indicates the SMTP message was received over TLS (encrypted).

linksstring[]

List of any URLs that were found in the text and HTML body of the message.

spamnumber

Experimental - result of spam filter scan, between 0.0 and 1.0, where 1.0 indicates a high likelihood of being spam

Example response

[
  {
    "_id": "m3phnJ2ag3example-0",
    "domain": "example.com",
    "received": "1985-04-12T23:20:50.52Z",
    "attachments": [
      "5ea9c924627e68f988c9c7ca44340892"
    ],
    "spam": 0.345
  }
]

Changes

  • 4067269b0d5aRevision changes
    • breaking

      the response's body type changed from object to array for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id ListMessages was added

    • info

      api tag Messages added

    • info

      api tag Email Messages API removed