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

# Fetch Logs

`GET /messages`

Retrieves a paginated list of email event logs with multiple filtering options. You can filter logs by time range, event type, recipient details, sender details, and more. Supported Authorization type is “Bearer” along with value of your Email API KEY Which you can find in your Email API account under Settings >Integrations > API.
This endpoint supports scroll-based pagination via the `scrollId` mechanism.  The maximum number of records per request is 1000. If no limit is specified, 50 records will be returned.
**Supported event types:**   `processed`, `sent`, `open`, `click`, `unsubscribe`, `bounce`, `softbounce`, `spam`, `invalid`, `dropped`, `hardbounce`, `scheduled`, `cancelled`

## Query parameters

- `start_date` string, date, required
- `end_date` string, date
- `event_start_date` string, date-time, required
- `event_end_date` string, date-time
- `events` string[]
- `email` string
- `subject` string
- `custom_args` string
- `tags` string
- `fromaddress` string
- `fromdomain` string
- `recipient_domain` string
- `message_id` string
- `limit` integer
- `sort` 'asc' | 'desc'
- `scrollid` string

## Headers

- `on_behalf_of` string

## Response `200`

Logs fetched successfully.

- object
  - `data` object[]
  - `scrollId` string

## Other responses

- `400` — Bad Request – Invalid date ranges or malformed parameters.

---

[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)