Analytics Dashboard

Monitor your email performance with delivery metrics, open rates, and volume trends in Taifa Mail.

The Analytics dashboard gives you a real-time view of your email sending performance. Access it from the Analytics tab in the sidebar.

Full analytics (time-series charts, rate breakdowns) require the Starter plan or above. Free plan users see total counts only.

Overview metrics

The top of the dashboard shows aggregate counts for the selected period:

Metric	Description
Total Sent	Number of emails created in the period.
Delivered	Emails confirmed delivered to the recipient's server.
Bounced	Emails permanently rejected by the recipient's server.
Failed	Emails that could not be sent due to internal errors.
Opens	Number of distinct emails opened at least once. An email opened several times counts once.
Clicks	Number of distinct emails with at least one tracked-link click.

Time period selector

Use the period selector to filter all metrics. The supported periods are:

24 hours - last 24 hours
7 days - last 7 days
30 days - last 30 days (default)
90 days - last 90 days

Email volume chart

A chart shows email volume bucketed over the selected period. Each bucket plots sent, delivered, bounced, failed, and opens. Buckets can be grouped by hour or day.

API access

You can fetch the same analytics data programmatically. The endpoints live under /v1/analytics.

Overview

curl "https://govconnect.ke/v1/analytics/overview?period=7d" \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY"

opens and clicks are counts of distinct emails, not raw event totals.

Response:

{
  "period": "7d",
  "total_sent": 12450,
  "delivered": 12102,
  "bounced": 203,
  "failed": 15,
  "opens": 3210,
  "clicks": 890
}

Time-series

curl "https://govconnect.ke/v1/analytics/timeseries?period=30d&granularity=day" \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY"

granularity accepts hour or day (default day). Each point is timestamped at the start of its bucket.

Response:

{
  "period": "30d",
  "granularity": "day",
  "data": [
    {
      "timestamp": "2026-03-07T00:00:00Z",
      "sent": 410,
      "delivered": 398,
      "bounced": 8,
      "failed": 0,
      "opens": 152
    },
    {
      "timestamp": "2026-03-08T00:00:00Z",
      "sent": 385,
      "delivered": 377,
      "bounced": 5,
      "failed": 1,
      "opens": 140
    }
  ]
}

Domain stats

The /domain-stats endpoint breaks volume down by recipient domain, returning the top domains by send count:

curl "https://govconnect.ke/v1/analytics/domain-stats?period=30d&limit=20" \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY"

Response:

[
  {
    "domain": "gmail.com",
    "sent": 5210,
    "delivered": 5102,
    "bounced": 41,
    "opens": 1840,
    "clicks": 520
  }
]

limit accepts 1-100 (default 20).

Use the time-series and domain-stats endpoints to build custom dashboards or pipe data into your own analytics stack.

Valid period values

Value	Meaning
`24h`	Last 24 hours
`7d`	Last 7 days
`30d`	Last 30 days
`90d`	Last 90 days

Analytics Dashboard

On this page