Get email statistics (incoming, sent, spam, responses)
Email Statistics
Email Count Statistics
Returns email conversation and thread statistics for a specified date range. - Counts total conversations, responded conversations, spam, and “no response required” messages. - Tracks incoming and sent email counts, average thread size, and number of unique email addresses involved.
GET
Get email statistics (incoming, sent, spam, responses)
Returns email conversation and thread statistics for a specified date range. Counts total conversations, responded conversations, spam, and “no response required” messages. Tracks incoming and sent email counts, average thread size, and number of unique email addresses involved.
Request
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer token |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| startDate | string | Yes | Start date for the report (ISO 8601 format). Defaults to a week from today if invalid |
| endDate | string | Yes | End date for the report (ISO 8601 format). Defaults to today if invalid |
Parameter Format
- Format:
YYYY-MM-DDTHH:mm:ss.sssZ(ISO 8601) - Timezone: UTC
- Default: Last 7 days if not provided or invalid
Response
200 OK - Successfully retrieved email statistics
400 Bad Request
401 Unauthorized
500 Internal Server Error
Examples
Get statistics for specific date range
Get statistics for last 7 days (default)
Data Fields Explained
Conversations
| Field | Type | Description |
|---|---|---|
| total | integer | Total number of email conversations |
| responded | integer | Conversations that received responses |
| spam | integer | Messages identified as spam |
| noResponseRequired | integer | Messages that don’t need responses |
Thread Counts
| Field | Type | Description |
|---|---|---|
| incoming | integer | Total incoming emails |
| sent | integer | Total sent emails |
| average | number | Average thread size (emails per conversation) |
Unique Addresses
| Field | Type | Description |
|---|---|---|
| uniqueAddresses | integer | Count of unique email addresses involved |
Use Cases
- Email Volume Analysis: Track overall email activity
- Spam Monitoring: Monitor spam email trends
- Response Rate: Calculate email response rates
- Engagement Metrics: Measure email thread engagement
- Contact Analysis: Understand unique contact interactions
Metrics Calculations
Response Rate
Spam Rate
Average Threads per Day
Performance Considerations
- Date Range: Larger ranges may take longer to process
- Caching: Results may be cached for recent queries
- Real-time Data: Statistics reflect current email state
- Historical Analysis: Supports analysis of historical trends
Best Practices
- Date Range: Use reasonable date ranges (recommended: max 90 days)
- Time Zone: All times are in UTC - convert for local display
- Caching: Cache results for dashboard performance
- Error Handling: Handle invalid dates gracefully
- Rate Limiting: Avoid excessive API calls for real-time updates
Related Endpoints
- Use
/email-meter/stats/emails-trendfor daily breakdown - Use
/email-meter/stats/response-timesfor timing analysis - Use
/email-meter/stats/clients/top-domainsfor domain insights
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Start date for the report (ISO 8601 format). If invalid or missing, defaults to a week from today.
End date for the report (ISO 8601 format). If invalid or missing, defaults to today.