Get Email Statistics by Country
get_stats_by_countryRetrieve email engagement statistics grouped by country, with metrics for clicks and opens. Filter results by ISO country code, date range, and daily/weekly/monthly aggregation.
Instructions
Retrieve email statistics grouped by country. Only clicks, unique_clicks, opens, and unique_opens metrics are available. Filtering is by country only (no state/province filter exists).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start_date": "<start_date>"
},
"name": "get_stats_by_country"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of results to return per page (SendGrid defaults to 500) | |
| offset | No | Number of results to skip for pagination | |
| country | No | ISO 3166-1 alpha-2 country code to filter by | |
| end_date | No | End date in YYYY-MM-DD format (defaults to today) | |
| start_date | Yes | Start date in YYYY-MM-DD format | |
| aggregated_by | No | How to group the statistics | day |