---
title: "Get all your transactional email activity (unaggregated events)"
method: GET
path: "/smtp/statistics/events"
tags: ["Transactional emails"]
---

# Get all your transactional email activity (unaggregated events)

`GET /smtp/statistics/events`

This endpoint will show the aggregated stats for past 30 days by default if `startDate` and `endDate` OR `days` is not passed. The date range can not exceed 90 days

## Query parameters

- `limit` integer
- `offset` integer
- `startDate` string
- `endDate` string
- `days` integer
- `email` string, email
- `event` 'bounces' | 'hardBounces' | 'softBounces' | 'delivered' | 'spam' | 'requests' | 'opened' | 'clicks' | 'invalid' | 'deferred' | 'blocked' | 'unsubscribed' | 'error' | 'loadedByProxy'
- `tags` string
- `messageId` string
- `templateId` integer
- `sort` 'asc' | 'desc'

## Response `200`

Email events report informations

- GetEmailEventReport
  - `events` GetEmailEventReportEvents[]
    - `email` string, email, required — Email address which generates the event
    - `date` string, required — UTC date-time on which the event has been generated
    - `subject` string — Subject of the event
    - `messageId` string, required — Message ID which generated the event
    - `event` 'bounces' | 'hardBounces' | 'softBounces' | 'delivered' | 'spam' | 'requests' | 'opened' | 'clicks' | 'invalid' | 'deferred' | 'blocked' | 'unsubscribed' | 'error' | 'loadedByProxy', required — Event which occurred
    - `reason` string — Reason of bounce (only available if the event is hardbounce or softbounce)
    - `tag` string — Tag of the email which generated the event
    - `ip` string — IP from which the user has opened the email or clicked on the link (only available if the event is opened or clicks)
    - `link` string — The link which is sent to the user (only available if the event is requests or opened or clicks)
    - `from` string, email — Sender email from which the emails are sent
    - `templateId` integer — ID of the template (only available if the email is template based)

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/versions/2aec3cf66501/schema)