---
title: "List email notification histories"
method: GET
path: "/v1/notification-history/email"
tags: ["Notifications"]
---

# List email notification histories

`GET /v1/notification-history/email`

Describes how to get a notification history for notification emails.


### Notes
Request parameters and their values may be appended with a "?" following the HTTPS GET request.  Additional request parameter are separated by "&". 

For example:

`GET https://rest.zuora.com/v1/notification-history/email?startTime=2015-01-12T00:00:00&endTime=2015-01-15T00:00:00&failedOnly=false&eventCategory=1000&pageSize=1`

## Query parameters

- `page` integer
- `pageSize` integer
- `accountId` string
- `endTime` string, date-time
- `startTime` string, date-time
- `objectId` string
- `failedOnly` boolean
- `eventCategory` number

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GETEmailHistoryVOsType
  - `emailHistories` GETEmailHistoryVOType[] — A container for email histories.
    - `accountId` string — ID of an account.
    - `bcc` string — Blind carbon copy recipients of the email.
    - `cc` string — Carbon Copy recipients of the email.
    - `errorMessage` string, nullable — null if the content of result is "OK". A description of the error if the content of result is not "OK".
    - `eventCategory` string — The event category of the email.
    - `fromEmail` string — The sender of the email.
    - `notification` string — The name of the notification.
    - `replyTo` string — The reply-to address as configured in the email template.
    - `result` string — The result from the mail server of sending the email.
    - `sendTime` string — The date and time the email was sent.
    - `subject` string — The subject of the email.
    - `toEmail` string — The intended recipient of the email.
  - `nextPage` string, URL — URL to retrieve the next page of the response if it exists; otherwise absent.
  - `success` boolean — Returns `true` if the request was processed successfully.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)