# Query email events

Query email events with advanced filtering.
Note: This is an enterprise feature that must be enabled on your account.
Requires enable_event_tracking and enable_event_api to be enabled.

Endpoint: GET /api/v1/events
Version: 1.0.0
Security: BearerAuth

## Query parameters:

  - `email_id` (string)
    Filter by specific email ID

  - `type` (string)
    Filter by event type
    Enum: "queued", "sent", "delivered", "bounced", "complained", "opened", "clicked", "unsubscribed"

  - `recipient` (string)
    Filter by recipient email (partial match)

  - `from` (string)
    Filter by sender email (partial match)

  - `from_timestamp` (string)
    Filter events from this timestamp

  - `to_timestamp` (string)
    Filter events until this timestamp

  - `page` (integer)

  - `limit` (integer)

## Response 200 fields (application/json):

  - `events` (array)

  - `events.id` (string)

  - `events.email_id` (string)

  - `events.customer_id` (string)

  - `events.event_type` (string)
    Enum: "queued", "sent", "delivered", "bounced", "complained", "opened", "clicked", "unsubscribed"

  - `events.status` (string)

  - `events.recipient` (string)

  - `events.from` (string)

  - `events.timestamp` (string)

  - `events.event_data` (object)
    Additional event metadata (may be redacted based on privacy level)

  - `events.created_at` (string)

  - `pagination` (object)

  - `pagination.page` (integer)

  - `pagination.limit` (integer)

  - `pagination.total` (integer)
    Total number of items

  - `pagination.pages` (integer)
    Total number of pages

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 403 fields (application/json):

  - `error` (string)
    Enum: "event_tracking_disabled", "event_api_disabled"

  - `message` (string)

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message