Skip to content

Stream logs for authenticated user domain in real-time

GET
/api/domains/{domain}/log/stream

Stream email logs in real-time using Server-Sent Events for a domain owned by the authenticated user

domain
required
string
Example
example.com

Domain name that must be owned by the authenticated user. The domain must be verified and properly configured for email sending.

start
string format: date-time
Example
2023-01-01T00:00:00Z

Filter logs by start date (ISO8601)

end
string format: date-time
Example
2023-12-31T23:59:59Z

Filter logs by end date (ISO8601)

sender
string
Example

Filter logs by sender email

recipient
string
Example

Filter logs by recipient email

subject
string
Example
Welcome

Filter logs by subject (partial match)

event_type
string
Example
delivered

Filter logs by event type (queued, delivered, bounced, failed, opened, clicked, unsubscribed, temporary_fail, permanent_fail, deferred)

tags
string
Example
newsletter

Filter logs by tags (partial match)

limit
integer
default: 50000 >= 1 <= 500000

Maximum number of logs to stream

Server-Sent Events stream

SSE stream with log data batches and completion events

string
X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Bad Request - User authentication missing

object
error
string
Example
User authentication missing

Unauthorized - Invalid or missing authentication

object
error
string
Example
Unauthorized

Not Found - Domain or log not found

object
error
string
Example
Domain not found or you do not own this domain

Too Many Requests - Rate limit exceeded. Retry after the specified time.

object
success
boolean
message
string
Example
Too many attempts. Please try again later.
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Server Error - Unexpected error occurred

object
error
string
Example
Unknown error