eSMS Mail
Analytics
Email delivery metrics and time-series data.
eSMS Mail provides analytics for tracking your email performance over time.
Overview
Get aggregate metrics for a given period:
curl "https://send.esmsafrica.io/v1/analytics/overview?period=30d" \
-H "Authorization: Bearer esms_k_your_api_key"{
"period": "30d",
"total_sent": 12450,
"delivered": 12100,
"bounced": 85,
"failed": 15,
"opens": 4200,
"clicks": 890
}Periods
| Value | Description |
|---|---|
7d | Last 7 days |
30d | Last 30 days (default) |
90d | Last 90 days |
Time series
Get metrics broken down over time:
curl "https://send.esmsafrica.io/v1/analytics/timeseries?period=30d&granularity=day" \
-H "Authorization: Bearer esms_k_your_api_key"{
"period": "30d",
"granularity": "day",
"data": [
{
"timestamp": "2025-01-01T00:00:00Z",
"sent": 450,
"delivered": 440,
"bounced": 3,
"failed": 0
},
{
"timestamp": "2025-01-02T00:00:00Z",
"sent": 380,
"delivered": 375,
"bounced": 1,
"failed": 0
}
]
}Granularity
| Value | Description |
|---|---|
hour | Hourly data points |
day | Daily data points (default) |
Breakdown
Counts per tag, sending domain or stream (default) for a period:
curl "https://send.esmsafrica.io/v1/analytics/breakdown?period=30d&dimension=tag" \
-H "Authorization: Bearer esms_k_your_api_key"The response has period, dimension and rows, each with key, label, sent, delivered, bounced, failed, opens and clicks. With dimension=tag an email counts once under each of its tags.
CSV export
Download the period's emails (one row per message, up to 50,000):
curl -o emails.csv "https://send.esmsafrica.io/v1/analytics/export?period=30d" \
-H "Authorization: Bearer esms_k_your_api_key"Dashboard charts
The eSMS Mail dashboard at send.esmsafrica.io includes interactive charts for:
- Emails sent over time
- Delivery rate
- Open rate
- Click rate
- Bounce rate
Charts are available on the Starter plan and above.