Get Specific Email Details

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Retrieve detailed information about a specific outgoing email using its email reference ID.

Request URL

https://cpaas.zoho.com/v1.1/email/email-reference/{email-reference} Copied!

Scope

Zeptomail.email.READCopied!
(or)
Zeptomail.email.ALLCopied!

Request Parameters

- Path Parameters

email-referencestringMandatory

Unique reference ID of the email.

Example
ref-xxxx-xxxx

Sample Request

Curl
Java
Python
Deluge
Copied!
curl --request GET \
  --url https://cpaas.zoho.com/v1.1/email/email-reference/{email-reference} \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Show Sub-Attributes
dataobject
email_referencestringread-only
Example
ref-xxxx-xxxx
sent_timestringread-only
Example
2025-06-04T08:19:00Z
client_referencestringread-only
Example
order-12345
opened_timestringread-only
Example
2025-06-04T08:25:00Z
subjectstringread-only
Example
Account Confirmation
clicked_timestringread-only
Example
2025-06-04T08:26:00Z
fromstringread-only
Example
accounts@info.zylker.com
tostringread-only
Example
rudra.d@zylker.com
request_idstringread-only
Example
req-xxxx
mailagent_keystringread-only
Example
123456abcd78
statusstringread-only
Example
delivered
statusstringread-only
Example
success

- HTTP code 404

Response Body - application/json
JSON Object
Show Sub-Attributes
errorJSON Object
Show Sub-Attributes
codestringread-only
Example
EL_404
messagestringread-only
Example
Email log not found
statusstringread-only
Example
failure

Sample Response: HTTP 200

Copied!
  {
    "data": {
      "email_reference": "ref-xxxx-xxxx",
      "sent_time": "2025-06-04T08:19:00Z",
      "client_reference": "order-12345",
      "opened_time": "2025-06-04T08:25:00Z",
      "subject": "Account Confirmation",
      "clicked_time": "2025-06-04T08:26:00Z",
      "from": "accounts@info.zylker.com",
      "to": "rudra.d@zylker.com",
      "request_id": "req-xxxx",
      "mailagent_key": "123456abcd78",
      "status": "delivered"
    },
    "status": "success"
  }
                
▼ Show full

Sample Response: HTTP 404

Copied!
  {
    "error": {
      "code": "EL_404",
      "message": "Email log not found"
    },
    "status": "failure"
  }
                
▼ Show full