Skip to main content
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

Path Parameters

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

Thread Counts

Unique Addresses

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

  1. Date Range: Use reasonable date ranges (recommended: max 90 days)
  2. Time Zone: All times are in UTC - convert for local display
  3. Caching: Cache results for dashboard performance
  4. Error Handling: Handle invalid dates gracefully
  5. Rate Limiting: Avoid excessive API calls for real-time updates
  • Use /email-meter/stats/emails-trend for daily breakdown
  • Use /email-meter/stats/response-times for timing analysis
  • Use /email-meter/stats/clients/top-domains for domain insights

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

startDate
string<date-time>
required

Start date for the report (ISO 8601 format). If invalid or missing, defaults to a week from today.

endDate
string<date-time>
required

End date for the report (ISO 8601 format). If invalid or missing, defaults to today.

Response

Successfully retrieved email statistics

message
string
Example:

""

data
object