Close menu
Explore Plans
Mobile menu Close menu
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 code
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 code
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 code
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 code
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 code
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 code
Sendgrid.getEmailStatistics.StatSpamReports
Type
String
Example
2