Get Meta Data of an Email

Purpose

The API retrieves the metadata information of an email based on the message ID passed in the request URL.

OAuth Scope

Use the scope

ZohoMail.messages.ALL (or) ZohoMail.messages.READ

to generate the Authtoken.

ALL - Grants full access to messages.

READ - Grants access to read messages.

Request URL

Method: GET

https://mail.zoho.com/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/details

Path Parameters

  • accountId* long
    • This parameter is used to identify the specific account to fetch details.
    • This parameter can be retrieved from the Get User Account Details API.
  • folderId* long
    • This parameter is used to identify the specific folder for which the emails need to be retrieved. 
    • This parameter can be retrieved from the Get All Folders API.
  • messageId* long
    • This parameter is the unique ID associated with the particular email. 
    • This parameter can be retrieved from List Emails API.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/accounts/12345678/folders/9000000002014/messages/1709876190693100009/details" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Sample Response

Copied{
   "status": {
       "code": 200,
       "description": "success"
   },
   "data": {
       "summary": "Hello Sent using Zoho Mail",
       "sentDateInGMT": "1709856390000",
       "calendarType": 0,
       "subject": "Test",
       "messageId": "1709876190693100009",
       "flagid": "info",
       "status2": "0",
       "priority": "3",
       "hasInline": "false",
       "toAddress": ""autocview_adminuser"<autocview_adminuser@zmaillb.com>",
       "folderId": "9000000002014",
       "ccAddress": "Not Provided",
       "hasAttachment": "0",
       "size": "873",
       "sender": "paula",
       "receivedTime": "1709876190649",
       "fromAddress": "rebecca@zylker.com",
       "status": "1"
   }
}