---
title: "Fetch Event Logs"
method: GET
path: "/events"
tags: ["Events API"]
---

# Fetch Event Logs

`GET /events`

**Lets you to retrieve the email transaction logs.**

Following events can be passed in query parameter `events`:

* Processed
* Sent
* Bounce (Hard bounce and Soft bounce)
* Dropped
* Invalid
* Opened
* Clicked
* Unsubscribe
* Abuse

you can also pass Aggregate events :

* total_requested (Includes all entries)
* total_delivered (Includes 'Sent', 'Open', 'Click', 'Unsubscribe' and 'Spam')
* total_opened (Includes 'Open', 'Click', 'Unsubscribe' and 'Spam')
* total_clicked (Includes 'Click' and 'Unsubscribe')

Make sure to pass the above events individually as any combination including the above 4 event types will return an error. Data fetching is based on a combination of 'limit' & 'scrollid'.	'limit' indicates the number of rows that will be passed in the response. The maximum number of rows allowed for a single request is 5000. If the 'limit' is not set, 50 rows are retrieved. In the response message, the 'scrollid' is shared for that request. To fetch the next batch of rows, The 'scrollid' needs to be passed.

## Query parameters

- `scrollid` string
- `offset` integer
- `fromaddress` string
- `email` string
- `xapiheader` string
- `subject` string
- `limit` integer
- `enddate` string, date
- `startdate` string, date
- `sort` 'asc' | 'desc'
- `events` 'processed' | 'sent' | 'open' | 'click' | 'unsubscribe' | 'bounce' | 'softbounce' | 'spam' | 'invalid' | 'dropped' | 'hardbounce'

## Headers

- `api_key` string, required

## Response `200`

Success

- object

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)