Retrieve Email Statistics for Categories

GET https://api.sendgrid.com/v3/categories/stats?start_date={{start_date}}&end_date={{end_date}}&categories={{categories}}&limit=500&offset={{offset}}&aggregated_by={{aggregated_by}}

This endpoint allows you to retrieve all of your email statistics for each of your categories.

If you do not define any query parameters, this endpoint will return a sum for each category in groups of 10.

Categories allow you to group your emails together according to broad topics that you define. For more information, please see our User Guide.

Request Params

KeyDatatypeRequiredDescription
start_datestring
end_datestring
categoriesstring
limitnumber
offsetstring
aggregated_bystring

HEADERS

KeyDatatypeRequiredDescription
Acceptstring