GET - Retrieve Meta Data Information from a Single email

 Purpose

The API retrieves the metadata information of a single email based on the Message ID passed in the Request URL. 

 Request URL

 https://mail.zoho.com/api/accounts/<accountId>/folders/<folderid>/messages/<messageId>/details

Request Parameters

ParameterData TypeDescription
accountID*IntegerThe unique Identifier for a specific account of a user.  
folderId*IntegerFolder Id of the folder for which the emails need to be retrieved. 
messageId*IntegerThe unique ID associated with the particular email. 

Response Parameters

ParameterData TypePossible ValuesDescription
hasAttachmentboolean0 - false; 1 - trueWhether the email has an attachment or not
fromAddressemail addresssendername@domainname.comThe email address from which the email is sent
folderIdint-Folder id in which the emails are present
messageIdint-The unique id associated with each email
senderstring-The username of the email sender
summarystring-The summary of the email displayed in the email listing
status2int0 - default; 1 - replied; 2 - forward; 3 - replied and forwardedIf the email has been replied to, forwarded or replied to and forwarded
sentDateinGMTlong-The date when the email has been sent
sizeint-The size of the email
statusint0 - unread; 1- readThe read or unread state of the email
priorityint1 - highest; 2 - High; 3 - Normal; 4 - low; 5 - lowestThe priority set for the email
threadCountint-The number of emails that are part of this conversation
flagidstringflag_not_set; info; important; followupThe identifier for the flag that has been set
subjectstring-The subject of the email
threadIdlong int-The id for the relevant thread 
receivedtimelong-The time when the email was received

 Response Codes

Please refer Response Codes.

Sample Response


				{
  "status": {
    "code": 200,
    "description": "success"
  },
  "data": {
    "URI": "http://mail.zoho.com/api/accounts/333000000123/folders/3000000000609/messages/3000000013077",
    "hasAttachment": 0,
    "fromAddress": "mysender@someservice.com",
    "folderId": 3000000000609,
    "messageId": 3000000013077,
    "sender": "Paula",
    "summary": "World is measured in divisions of 8 hours ",
    "status2": "1",
    "sentDateInGMT": 1270171976000,
    "size": 540,
    "status": "1",
    "priority": 3,
    "threadCount": 0,
    "flagid": "flag_not_set",
    "subject": "Hello World",
    "threadId": 1,
    "receivedtime": 1425388373920
  }
}