Explore Plans
SendGrid

Get email statistics

Pro plus icon This query returns aggregate email statistics for the date range you specify.

Developer info

API endpoint slug
sendgrid.get_email_statistics
Runtime method
performQuery("sendgrid.get_email_statistics"}

Query fields

Start date Text input > Regular expression

Label
Start date
Helper text
The first day to include, in YYYY-MM-DD format.
Slug
start_date
Required
true
Can have default value
true

End date Text input > Regular expression

Label
End date
Helper text
The last day to include, in YYYY-MM-DD format. Leave blank to report through today.
Slug
end_date
Required
false
Can have default value
true

Aggregate by Dropdown list

Label
Aggregate by
Helper text
Optional. How SendGrid groups the returned statistics.
Slug
aggregate_by
Required
false
Can have default value
true

Ingredients

Stat requests Number of emails requested over the date range. Numeric value as a string.

Slug
stat_requests
Filter
Sendgrid.getEmailStatistics.StatRequests
Type
String
Example
1280

Stat delivered Number of emails delivered over the date range. Numeric value as a string.

Slug
stat_delivered
Filter
Sendgrid.getEmailStatistics.StatDelivered
Type
String
Example
1245

Stat opens Number of opens over the date range. Numeric value as a string.

Slug
stat_opens
Filter
Sendgrid.getEmailStatistics.StatOpens
Type
String
Example
812

Stat clicks Number of clicks over the date range. Numeric value as a string.

Slug
stat_clicks
Filter
Sendgrid.getEmailStatistics.StatClicks
Type
String
Example
204

Stat bounces Number of bounces over the date range. Numeric value as a string.

Slug
stat_bounces
Filter
Sendgrid.getEmailStatistics.StatBounces
Type
String
Example
35

Stat spam reports Number of spam reports over the date range. Numeric value as a string.

Slug
stat_spam_reports
Filter
Sendgrid.getEmailStatistics.StatSpamReports
Type
String
Example
2