Two useful "how am I doing" endpoints:
/users/info gives you the account-level
reputation and lifetime counters, and
/tags/all-time-series gives hourly stats
for the last 30 days across all tags. Together they cover "am I healthy?"
and "what's been happening recently?"
Fetch both
Account';
echo '';
echo '| Username | ' . h($info['username'] ?? '') . ' |
|---|
';
echo '| Public ID | ' . h($info['public_id'] ?? '') . ' |
|---|
';
echo '| Account created | ' . h($info['created_at'] ?? '') . ' |
|---|
';
echo '| Reputation | ' . h((string)($info['reputation'] ?? '')) . ' / 100 |
|---|
';
echo '| Hourly quota | ' . h((string)($info['hourly_quota'] ?? '')) . ' |
|---|
';
echo '| Backlog | ' . h((string)($info['backlog'] ?? '')) . ' |
|---|
';
echo '
';
if (isset($info['stats']) && is_array($info['stats'])) {
echo 'Lifetime counters
';
echo '| Window | Sent | Hard bounces | Soft bounces | Rejects | Complaints | Unsubs | Opens | Clicks |
|---|
';
foreach ($info['stats'] as $window => $s) {
echo '';
echo '| ' . h($window) . ' | ';
echo '' . h((string)($s['sent'] ?? 0)) . ' | ';
echo '' . h((string)($s['hard_bounces'] ?? 0)) . ' | ';
echo '' . h((string)($s['soft_bounces'] ?? 0)) . ' | ';
echo '' . h((string)($s['rejects'] ?? 0)) . ' | ';
echo '' . h((string)($s['complaints'] ?? 0)) . ' | ';
echo '' . h((string)($s['unsubs'] ?? 0)) . ' | ';
echo '' . h((string)($s['unique_opens'] ?? 0)) . ' | ';
echo '' . h((string)($s['unique_clicks'] ?? 0)) . ' | ';
echo '
';
}
echo '
';
echo 'Windows: today, last_7_days, last_30_days, last_60_days, last_90_days, all_time.
';
}
}
if (!mandrill_is_error($stats_result) && is_array($stats_result['decoded'])) {
$series = $stats_result['decoded'];
if (count($series) === 0) {
echo 'Recent activity (last 30 days)
';
echo 'No activity in the last 30 days.
';
} else {
// Show the most recent 20 hours with activity
echo 'Recent activity (most recent first)
';
$series = array_reverse($series);
$series = array_slice($series, 0, 20);
echo '| Hour | Sent | Bounces | Rejects | Opens | Clicks |
|---|
';
foreach ($series as $s) {
echo '';
echo '| ' . h($s['time'] ?? '') . ' | ';
echo '' . h((string)($s['sent'] ?? 0)) . ' | ';
echo '' . h((string)(($s['hard_bounces'] ?? 0) + ($s['soft_bounces'] ?? 0))) . ' | ';
echo '' . h((string)($s['rejects'] ?? 0)) . ' | ';
echo '' . h((string)($s['unique_opens'] ?? 0)) . ' | ';
echo '' . h((string)($s['unique_clicks'] ?? 0)) . ' | ';
echo '
';
}
echo '
';
}
}
echo 'Raw responses
';
render_debug($info_result);
render_debug($stats_result);
}
?>
The calls
// Account-level info
$info = mandrill_call('/users/info');
echo $info['decoded']['reputation']; // 0-100
echo $info['decoded']['stats']['last_30_days']['sent'];
// Hourly stats, last 30 days, aggregated across all tags
$series = mandrill_call('/tags/all-time-series');
foreach ($series['decoded'] as $hour) {
echo $hour['time'] . ': sent=' . $hour['sent'];
}
What the numbers mean
| Field | Means |
|---|
reputation | Mandrill's 0–100 score for your account. Below ~25 and you'll hit throttling; over ~80 is healthy. |
hourly_quota | The maximum number of messages you can send per hour right now. Grows as your reputation grows. |
backlog | How many messages are queued but not yet sent. Should usually be 0. |
hard_bounces | Permanent delivery failures (bad address). These land the recipient on your denylist. |
soft_bounces | Temporary failures (mailbox full, out of office). Retried automatically. |
rejects | Messages Mandrill refused to send (unsigned domain, denylisted recipient, etc.) |
complaints | Recipients who marked you as spam. The one to watch — keep well below 0.1% of sent. |
Other useful stats endpoints
| Endpoint | What it gives you |
|---|
/tags/list | All tags with lifetime counters. |
/tags/time-series | Hourly 30-day stats for one tag. |
/senders/list | Per-sender (from_email) stats — useful if you send from multiple addresses. |
/messages/search | Query individual sent messages by date / tag / sender / recipient. |
Where to go from here
For production, the next things to wire up are webhooks
(so Mandrill can POST to your server when a message is delivered, opened,
clicked, bounced or complained) and idempotency (don't
re-send the same transactional email if your app retries a request). The
reference has full docs for both at
/developer/transactional/api/webhooks/
.
← Back to the overview