Skip to main content

​
What volume metrics measure

Volume metrics give you a high-level view of throughput. They report three counts:
  • processed: messages accepted by MailChannels for delivery.
  • delivered: messages successfully handed off to the recipient’s mail server.
  • dropped: messages that MailChannels could not process for delivery.
Use these metrics to track sending volume over time, detect spikes or drop-offs, and surface configuration issues that are causing messages to be dropped before they reach the recipient.

​
Example query

The example below requests daily processing and delivery counts for the first week of January 2026. 
#!/usr/bin/env bash
# Retrieve processed, delivered, and dropped counts for the first week of January 2026.
  set -u
  : "${MAILCHANNELS_API_KEY:?Set MAILCHANNELS_API_KEY before running}"

curl -G "https://api.mailchannels.net/tx/v1/metrics/volume" \
  -H "X-Api-Key: $MAILCHANNELS_API_KEY" \
  --data-urlencode "start_time=2026-01-01T00:00:00Z" \
  --data-urlencode "end_time=2026-01-07T23:59:59Z"
For a similar view that reports messages bounced by the recipient’s mail server instead, see performance metrics.