Filter all messages

GET https://api.sendgrid.com/v3/messages?query={{query}}&limit=10

In order to gain access to the Email Activity Feed API, you must purchase additional email activity history.

Filter all messages to search your Email Activity.

Queries may need to be URL encoded. URL encoding depends on how you're using the API - if you are trying it out here, or using one of the Libraries, we handle the encoding for you. If you are using cURL, or your own implementation, you probably need to encode it.

Queries have this format:

query={query_type}="{query_content}"

encoded, this would look like this:

query=type%3D%22query_content%22

for example:

Filter by a specific email - query=to_email%3D%22example%40example.com%22

Filter by subject line - query=subject%3d%22A%20Great%20Subject%22

You can filter by other operators besides =. We also accept !=, <, and >.

For a tutorial on how to get started, check out Getting Started with the Email Activity API.

Full list of basic query types and examples: (replace the data in quotes with the information you want to query)

For information about building combined queries, see Building compound Email Activity queries.

Request Params

HEADERS