Metrics

​

Introduction

The Metrics API provides analytics and visibility into your email sending performance. By leveraging these endpoints, you can monitor performance indicators, track user engagement, analyze delivery outcomes, and gain valuable insights into recipient behavior patterns. MailChannels groups metrics into five categories:

• Engagement: opens and clicks.
• Performance: processed, delivered, and bounced counts.
• Volume: processed, delivered, and dropped counts.
• Recipient Behavior: unsubscribe activity.
• Sender Breakdown: aggregate delivery performance grouped by campaign or sub-account.

​

Common parameters

All metric queries accept the same time filter:

• start_time and end_time: ISO 8601 timestamps that restrict the query to a time range. If omitted, start_time defaults to one month ago and end_time defaults to the current time.

Engagement, performance, volume, and recipient behavior additionally accept:

• campaign_id: restrict results to a single campaign.
• interval: controls bucket granularity for the time series. Supported values: hour, day (default), week, month.

Sender breakdown is an aggregate, not a time series, and accepts a different set of parameters. See sender breakdown for details.