Fetch Logs

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date
required

Start date in YYYY-MM-DD format (required).

date

Optional end date in YYYY-MM-DD format.

date-time
required

Start date and time in YYYY-MM-DD HH:mm:ss format (required).

date-time

Optional end date and time in YYYY-MM-DD HH:mm:ss format.

events
array of strings

Optional list of event types to filter logs by.

events
string

Filter by recipient email address.

string

Filter by email subject.

string

Filter by custom arguments passed in the email payload.

string

Filter by tags.

string

Filter by sender's email address.

string

Filter by sender's domain.

string

Filter by recipient's domain.

string

Filter logs based on message_id

integer
1 to 1000
Defaults to 50

Number of records to return. Maximum: 1000.

string
enum
Defaults to asc

Sort order for the logs based on sent time. Use asc or desc.

Allowed:
string

Scroll ID for fetching the next page of results.

Headers
string

Optional header used when making API calls with a master account’s API key. Allows performing actions for a specific subaccount by providing its username.

Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json