View and search sent emails

post deprecated

https://api.smtp2go.com/v3/email/search

Retrieve a list of up to 5,000 sent emails matching the supplied parameters.

The filter_query field can be used to create complex filters to make your searching more efficient. Find full details in the Email and Email Archive Guide.

Note: Allow around two minutes after delivery for recently sent emails to be included in a search result.

This endpoint is deprecated and will not be accessible in future API versions. Please use the Activity Search endpoint instead.This endpoint is rate-limited to 20 requests per minute.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

start_date

string

ISO-8601 formatted datetime. Results will be inclusive of this value. Timezone is UTC. Defaults to current date at midnight.

end_date

string

ISO-8601 formatted datetime. Results will be inclusive of this value. Timezone is UTC. Defaults to current time.

limit

int32

Defaults to 5000

The maximum number of emails to return. Enter an integer between 1 and 5,000. Defaults to 5,000.

status_counts

boolean

Defaults to false

If true, will return an object with counts of each unique email status

opened_only

boolean

Defaults to false

If true, will return emails that have been opened by at least one recipient.

Note: Only returns information for emails sent from suitable accounts with Open Tracking enabled. See more info at Open Tracking

clicked_only

boolean

Defaults to false

If true, will return emails that have had a link clicked by at least one recipient.

Note: Only returns information for emails sent from suitable accounts with Click Tracking enabled. See more info at Click Tracking

ignore_case

boolean

Defaults to false

If true, all string searches will be case insensitive

filter_query

string

Defaults to null

If passed, will return results filtered by these search parameters. The query format is documented below

email_id

array of strings

If passed, will only return emails with an ID contained within this array

email_id

username

string

If passed, will only return emails sent by this user

headers

array of strings

Defaults to []

If passed, will return the specified email header values

headers

continue_token

string

If passed, the resulting query will paginate from the previous query

200List of sent emails

400400