---
title: Get Email Stats
description: "The email stats API returns the results for a given email over a period of time. ### Request Parameters You may perform requests to the API using the following curl equivalent: ```js curl -H 'Content-Type: application/json' -H 'Authorization: Bearer '…"
url: "https://releva.ai/documentation/workflows-2/email-stats/"
updated: "2025-02-18"
category: Developer Documentation / Workflows
---

# Get Email Stats

The email stats API returns the results for a given email over a period of time.

### Request Parameters

You may perform requests to the API using the following curl equivalent:

```js
curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/emails/<emailId>/stats?fromDate=...&toDate=...
curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/emails/<emailId>/stats?segmentRunId=...
```

### Request URL Parameters

| Field | Type | Description |
| --- | --- | --- |
| emailId | String | The email id to show stats for |

### Request Query Parameters

| Field | Type | Description |
| --- | --- | --- |
| fromDate | [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) String (Optional) | The start date of the period to show results for |
| toDate | [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) String (Optional) | The end date of the period to show results for |
| segmentRunId | String (Optional) | The segment run ID for which to show results |

A successful response will return HTTP Status **200** and a JSON body with the following structure:

```plain
{
  "emailSent": 0,
  "emailOpens": 0,
  "emailClicks": 0,
  "emailBounces": 0,
  "emailComplaints": 0,
  "emailRejects": 0,
  "emailReschedules": 0
}
```

### Response Format

An error response will return a HTTP **4xx** or **5xx** status code and have the following structure:

```js
{
  "message": "A description of the error and how to fix it, if it's a client error."
}
```