GET allmessages.json

Returns all emails on the account. This is useful if you're polling a mailbox for new messages and want all new messages indexed since a given timestamp.

GET https://api.context.io/1.1/allmessages.json?since=timestamp

Parameters

since

Integer representing the UNIX timestamp from which you want to retrieve messages. This timestamp isn't the sent date of the email, it is the time Context.IO indexed this message.

Note that the response for any API call always includes the timestamp on the server at the end of code execution (see responseformat). If your polling a mailbox, you can use this timestamp as a reference from one call to another.

limit

Integer representing the maximum number of results to return. Its default value (if not specified) is 25.

account

The email address of the account you want to get data from. This parameter must be set if your API key has access to more than one email account (see imap/addaccount).

Response

The response is a list of emails:

{
  ...
  data: [
    {
      emailMessageId: (string) Value of Message-ID header of the message,
      date: (integer) Sent time of the message (unix timestamp),
      subject: (string) Subject of the message ,
      gmailMessageId: (string) Only applicable for Gmail/Google Apps mailboxes,
      gmailThreadId: (string) Only applicable for Gmail/Google Apps mailboxes,
      addresses: (object) Information about the sender and recipient(s) of the message, see details below,
      personInfo: (object) Information about the sender and recipient(s) of the message, see details below,
      files: [
        {
          fileId: (string) Unique ID assigned to that file,
          fileName: (string) Name of the file,
          fileNameStructure: (array) Name of the file broken down into its semantic parts, see details below,
          size: (integer) Size of the file in bytes,
          supportsPreview: (boolean) If TRUE, you can show a preview of that file, see details below,
          type: (string) MIME type of the file as specified in header of the message body part containing the attachment,
        },
        ...
      ]
    },
    ...
  ]
}

addresses

Indicates information about the sender and recipient(s) of the message. See message addresses information for more information.

personInfo

Indicates information about the sender and recipient(s) of the message. See message person information for more information.

files[i].fileNameStructure

This property is an array representing the file name broken down in its semantic parts. It can be used to assign styles to highlight these different parts of the file name. See Breaking down file names for more information.

files[i].supportsPreview

Our API offers web based file previews for many common file types, see here for more information. This property indicates whether it can be used for this particular occurrence.

files[i].type

MIME types are returned as they are specified in the message source except for cases where the specified type is application/octet-stream. In that case, we check the file extension and override the MIME type with a more precise one if possible.