---
title: "Get All Email Logs"
method: GET
path: "/email"
tags: ["email logs"]
---

# Get All Email Logs

`GET /email`

## Request

- Base URL: `https://cpaas.zoho.com/v1.1`
- URL: `https://cpaas.zoho.com/v1.1/email`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://accounts.zoho.com/oauth/v2/auth`
    - Token URL: `https://accounts.zoho.com/oauth/v2/token` scopes: `Zeptomail.email.READ`
  - OAuth 2
    - Authorization code: `https://accounts.zoho.com/oauth/v2/auth`
    - Token URL: `https://accounts.zoho.com/oauth/v2/token` scopes: `Zeptomail.email.ALL`

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

## Query parameters

- `mailagent_key` string
- `request_id` string
- `date_from` string
- `date_to` string
- `from` string
- `to` string
- `cc` string
- `bcc` string
- `recipient` string
- `offset` integer
- `limit` integer
- `subject` string
- `client_reference` string
- `is_hb` boolean
- `is_sb` boolean
- `is_mailfailure` boolean
- `is_delivered` boolean

## Response `200`

List of email logs.

- object
  - `data` EmailLog[]
    - `email_reference` string
    - `sent_time` string
    - `subject` string
    - `from` string
    - `to` string
    - `request_id` string
    - `mailagent_key` string
    - `status` string
  - `status` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/zoho/apis/zoho-cpaas.md) - [All operations](https://skmtc.dev/zoho/apis/zoho-cpaas/llms.txt) - [OpenAPI document](https://skmtc.dev/zoho/apis/zoho-cpaas/revisions/f0858a38e8b0?raw)