# Twilio SendGrid Statistics API API

> Twilio SendGrid Statistics API API on Apizie: 10 endpoints (Retrieve email statistics by browser., Retrieve all categories, Retrieve Email Statistics for Categories, Retrieve sums of email stats for each category., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:sendgrid-stats-v3/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:sendgrid-stats-v3`
- Category: Communication
- Status: byok
- Source: https://www.twilio.com/docs/sendgrid/api-reference
- Page: https://apizie.tech/api/communication/sendgrid-stats-v3
- OpenAPI: https://apizie.tech/api/communication/sendgrid-stats-v3/openapi.json

The Twilio SendGrid Statistics API allows you to retrieve the various statistics related to your email program. Tracking your emails is an important part of being a good sender and learning about how your users…

## Endpoints

### Retrieve email statistics by browser.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-browser-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| browsers | string | no | The browsers to get statistics for. You can include up to 10 different browsers by including this parameter multiple times. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |

### Retrieve all categories
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | `limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default… |
| category | string | no | Allows you to perform a prefix search on this particular category. |
| offset | integer | no | The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0`… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve Email Statistics for Categories
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-category-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |
| categories | string | yes | The individual categories that you want to retrieve statistics for. You may include up to 10 different categories. |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve sums of email stats for each category.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-category-stat-sum` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sort_by_metric | string | no | The metric that you want to sort by. Must be a single metric. |
| sort_by_direction | string | no | The direction you want to sort. |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |
| limit | integer | no | Limits the number of results returned. |
| offset | integer | no | The point in the list to begin retrieving results. |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve email statistics by client type.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-client-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |

### Retrieve stats by a specific client type.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/get-client-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| client_type | string | yes | Specifies the type of client to retrieve stats for. Must be either "phone", "tablet", "webmail", or "desktop". |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |

### Retrieve email statistics by device type.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-device-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |

### Retrieve email statistics by country and state/province.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-geo-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | no | The country you would like to see statistics for. Currently only supported for US and CA. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |

### Retrieve email statistics by mailbox provider.
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-mailbox-provider-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| mailbox_providers | string | no | The mail box providers to get statistics for. You can include up to 10 by including this parameter multiple times. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |

### Retrieve global email statistics
`GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |

## Example
```
curl "https://apizie.tech/v1/communication:sendgrid-stats-v3/list-browser-stat" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio SendGrid Statistics API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:sendgrid-stats-v3/list-browser-stat with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio SendGrid Statistics API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio SendGrid Statistics API itself also needs your own key from sendgrid.com.

### Can AI agents use the Twilio SendGrid Statistics API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:sendgrid-stats-v3.

### What is the status of the Twilio SendGrid Statistics API API?
Needs your own provider key (bring your own key)