---
title: "Get aggregated statistics"
method: GET
path: "/marketing/v3/emails/statistics/list"
tags: ["Basic"]
---

# Get aggregated statistics

`GET /marketing/v3/emails/statistics/list`

Use this endpoint to get aggregated statistics of emails sent in a specified time span. It also returns the list of emails that were sent during the time span.

## Query parameters

- `emailIds` integer[]
- `endTimestamp` string, date-time
- `property` string
- `startTimestamp` string, date-time

## Response `200`

successful operation

- AggregateEmailStatistics — Aggregated statistics for the given interval, plus the IDs of emails that were sent during that interval.
  - `aggregate` EmailStatisticsData
    - `counters` object, required — Counters like number of `sent`, `open` or `delivered`.
    - `deviceBreakdown` object, required — Statistics by device.
    - `qualifierStats` object, required — Number of emails that were dropped and bounced.
    - `ratios` object, required — Ratios like `openratio` or `clickratio`
  - `campaignAggregations` object — The aggregated statistics per campaign.
  - `emails` integer[] — List of email IDs that were sent during the time span.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/marketing-marketing-emails.md) · [All operations](https://skmtc.net/hubspot/apis/marketing-marketing-emails/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/marketing-marketing-emails/revisions/08bf14e01159/schema)