Skip to main content
GET
List Email Events
Retrieve email events (deliveries, bounces, opens, clicks, etc.) for your account. Events are returned in reverse chronological order.

Authorizations

Authorization
string
header
required

API key for authentication

Query Parameters

events
enum<string>[]

Comma-separated list of event types to filter by. Valid types: injection, delivery, bounce, delay, out_of_band, spam_complaint, policy_rejection, click, open, initial_open, amp_click, amp_open, amp_initial_open, generation_failure, generation_rejection, list_unsubscribe, link_unsubscribe.

Available options:
injection,
delivery,
bounce,
delay,
out_of_band,
spam_complaint,
policy_rejection,
click,
open,
initial_open,
amp_click,
amp_open,
amp_initial_open,
generation_failure,
generation_rejection,
list_unsubscribe,
link_unsubscribe
recipients
string<email>[]

Comma-separated list of recipient email addresses to filter by.

from
string<date>

Start of the event search range (ISO 8601, inclusive). Defaults to 10 days ago. Events are kept for about 10 days, so an earlier date is pulled forward; from in the response shows the window actually covered.

Example:

"2024-01-01"

to
string<date>

End of the event search range (ISO 8601, exclusive). Defaults to now. Must be after from, otherwise the request fails with a 422.

Example:

"2024-01-31"

per_page
integer
default:25

Number of events per page.

Required range: 1 <= x <= 100
Example:

25

cursor
string

Pagination cursor: the next_cursor value from the previous response. Any other value fails with a 422.

transmissions
string

Filter events by transmission ID (request_id).

Example:

"12345678901234567890"

bounce_classes
string

Comma-separated list of bounce classification codes to filter by.

Example:

"10,30"

Response

Email events retrieved successfully

message
string
required
Example:

"Email events retrieved successfully."

data
object
required