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
Parameter | Data Type | Description |
accountID* | Integer | The unique Identifier for a specific account of a user. |
folderId* | Integer | Folder Id of the folder for which the emails need to be retrieved. |
messageId* | Integer | The unique ID associated with the particular email. |
Response Parameters
Parameter | Data Type | Possible Values | Description |
hasAttachment | boolean | 0 - false; 1 - true | Whether the email has an attachment or not |
fromAddress | email address | sendername@domainname.com | The email address from which the email is sent |
folderId | int | - | Folder id in which the emails are present |
messageId | int | - | The unique id associated with each email |
sender | string | - | The username of the email sender |
summary | string | - | The summary of the email displayed in the email listing |
status2 | int | 0 - default; 1 - replied; 2 - forward; 3 - replied and forwarded | If the email has been replied to, forwarded or replied to and forwarded |
sentDateinGMT | long | - | The date when the email has been sent |
size | int | - | The size of the email |
status | int | 0 - unread; 1- read | The read or unread state of the email |
priority | int | 1 - highest; 2 - High; 3 - Normal; 4 - low; 5 - lowest | The priority set for the email |
threadCount | int | - | The number of emails that are part of this conversation |
flagid | string | flag_not_set; info; important; followup | The identifier for the flag that has been set |
subject | string | - | The subject of the email |
threadId | long int | - | The id for the relevant thread |
receivedtime | long | - | The time when the email was received |
Response Codes
Please refer Response Codes.
Sample Response
Copied{
"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
}
}