Get All Email Logs

Retrieve a list of outgoing email logs from your ZeptoMail account. Supports filtering by date range, recipient, subject, and more. Logs are retained for 60 days.

Endpoint

get /email

Copy full URL

Request URL

https://api.zeptomail.com/v1.1/email Copied!

Scope

Zeptomail.email.READCopied!

(or)

Zeptomail.email.ALLCopied!

Request Parameters

- Query Parameters

mailagent_keystringOptional

Filter logs by Mail Agent key.

request_idstringOptional

Filter by a specific request ID.

date_fromstringOptional

Filter logs from this date and time (format: dd/MM/yyyy, hh:mm a).

date_tostringOptional

Filter logs up to this date and time (format: dd/MM/yyyy, hh:mm a).

fromstringOptional

Filter by sender email address.

tostringOptional

Filter by recipient email address.

ccstringOptional

Filter by CC email address.

bccstringOptional

Filter by BCC email address.

recipientstringOptional

Filter by any recipient (To, CC, or BCC).

offsetintegerOptional

Starting position for pagination.

limitintegerOptional

Number of logs to return per request.

subjectstringOptional

Filter by email subject.

client_referencestringOptional

Filter by custom client reference.

is_hbbooleanOptional

Filter for hard bounced emails.

is_sbbooleanOptional

Filter for soft bounced emails.

is_mailfailurebooleanOptional

Filter for failed emails.

is_deliveredbooleanOptional

Filter for delivered emails.

Sample Request

Curl

Java

Python

Deluge

Copied!

curl --request GET \
  --url 'https://api.zeptomail.com/v1.1/email?mailagent_key=123456abcd78&request_id=req-xxxx&date_from=01/06/2025, 12:00 AM&date_to=30/06/2025, 11:59 PM&from=accounts@info.zylker.com&to=rudra.d@zylker.com&cc=manager@zylker.com&bcc=archive@zylker.com&recipient=user@example.com&offset=0&limit=25&subject=Account Confirmation&client_reference=order-12345&is_hb=SOME_BOOLEAN_VALUE&is_sb=SOME_BOOLEAN_VALUE&is_mailfailure=SOME_BOOLEAN_VALUE&is_delivered=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.zeptomail.com/v1.1/email?mailagent_key=123456abcd78&request_id=req-xxxx&date_from=01/06/2025, 12:00 AM&date_to=30/06/2025, 11:59 PM&from=accounts@info.zylker.com&to=rudra.d@zylker.com&cc=manager@zylker.com&bcc=archive@zylker.com&recipient=user@example.com&offset=0&limit=25&subject=Account Confirmation&client_reference=order-12345&is_hb=SOME_BOOLEAN_VALUE&is_sb=SOME_BOOLEAN_VALUE&is_mailfailure=SOME_BOOLEAN_VALUE&is_delivered=SOME_BOOLEAN_VALUE"))
        .header("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("api.zeptomail.com")

headers = { 'Authorization': "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52" }

conn.request("GET", "/v1.1/email?mailagent_key=123456abcd78&request_id=req-xxxx&date_from=01/06/2025, 12:00 AM&date_to=30/06/2025, 11:59 PM&from=accounts@info.zylker.com&to=rudra.d@zylker.com&cc=manager@zylker.com&bcc=archive@zylker.com&recipient=user@example.com&offset=0&limit=25&subject=Account Confirmation&client_reference=order-12345&is_hb=SOME_BOOLEAN_VALUE&is_sb=SOME_BOOLEAN_VALUE&is_mailfailure=SOME_BOOLEAN_VALUE&is_delivered=SOME_BOOLEAN_VALUE", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    parameters = "mailagent_key=value" + "&" + "request_id=value" + "&" + "date_from=value" + "&" + "date_to=value" + "&" + "from=value" + "&" + "to=value" + "&" + "cc=value" + "&" + "bcc=value" + "&" + "recipient=value" + "&" + "offset=value" + "&" + "limit=value" + "&" + "subject=value" + "&" + "client_reference=value" + "&" + "is_hb=value" + "&" + "is_sb=value" + "&" + "is_mailfailure=value" + "&" + "is_delivered=value";

    headersMap = Map();
    headersMap.put("Accept", "application/json");

    response = invokeUrl
    [
        url: "https://api.zeptomail.com/v1.1/email" + "?" + parameters
        type: GET
        headers: headersMap
        connection: connection_name
    ]

    info response;

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Show Sub-Attributes

dataJSON Array

Show Sub-Attributes

JSON Object

Show Sub-Attributes

email_referencestring

sent_timestring

subjectstring

fromstring

tostring

request_idstring

mailagent_keystring

statusstring

- HTTP code 400

Response Body - application/json

JSON Object

Show Sub-Attributes

errorJSON Object

Show Sub-Attributes

codestring

messagestring

statusstring

Possible Response Codes

200HTTP code

List of email logs.

400HTTP code

Bad Request

Sample Response: HTTP 200

Copied!

  {
    "data": [
      {
        "email_reference": "ref-xxxx-xxxx",
        "sent_time": "2025-06-04T08:19:00Z",
        "subject": "Account Confirmation",
        "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 400

Copied!

  {
    "error": {
      "code": "EL_404",
      "message": "Email log not found"
    },
    "status": "failure"
  }

▼ Show full