Email Activity
You must purchase additional email activity history to gain access to the Email Activity Feed API.
The Email Activity API allows you to query all of your stored messages, query individual messages, and download a CSV with data about the stored messages.
Once retrieved, you can inspect the data associated with your messages to better understand your mail send. For example, you may retrieve all bounced messages or all messages with the same subject line and search for commonalities among them.
See "Getting Started with the Email Activity Feed API" for help building queries and working with the API.
You can also work with email activity in the Activity section of the Twilio SendGrid App.
Filter all messages
GET /v3/messages
Base url: https://api.sendgrid.com
Filter all messages to search your Email Activity. All queries must be URL encoded, and use the following format:
query={query_type}="{query_content}"
Once URL encoded, the previous query will look like this:
query=type%3D%22query_content%22
For example, to filter by a specific email, use the following query:
query=to_email%3D%22example%40example.com%22
Visit our Query Reference section to see a full list of basic query types and examples.
Authentication
- API Key
Headers
Query String
Use the query syntax to filter your email activity.
default: NoneThe number of messages returned. This parameter must be greater than 0 and less than or equal to 1000
default: 10Responses
The 'From' email address used to deliver the message. This address should be a verified sender in your Twilio SendGrid account.
default: test0@example.comformat: emailA unique ID assigned to the message. This ID can be used to retrieve activity data for the specific message.
The email's subject line.
The intended recipient's email address.
format: emailThe message's status.
Allowed Values: processed, delivered, not_deliveredThe number of times the message was opened.
The number of times links in the message were clicked.
A timestamp of the last event received for the specific message in iso 8601 format.
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.
