JSON API & MCP access to your delivery data.

cURL — overview

curl -s "https://bigstats.email/api/public/v1/overview?range=7d" \
  -H "Authorization: Bearer $BIGSTATS_TOKEN"

cURL — bounce CSV export

curl -s "https://bigstats.email/api/public/v1/events?event_type=bounced&range=7d&format=csv&limit=5000" \
  -H "Authorization: Bearer $BIGSTATS_TOKEN" -o bounces.csv

JavaScript / TypeScript

const res = await fetch(
  "https://bigstats.email/api/public/v1/domains?range=30d&group_by=isp",
  { headers: { Authorization: `Bearer ${process.env.BIGSTATS_TOKEN}` } },
);
if (!res.ok) throw new Error(`BigStats API ${res.status}`);
const { rows } = await res.json();

for (const r of rows) {
  console.log(r.bucket, r.delivered, r.bounced);
}

Python

import os, requests

r = requests.get(
    "https://bigstats.email/api/public/v1/events",
    params={"event_type": "bounced", "limit": 1000},
    headers={"Authorization": f"Bearer {os.environ['BIGSTATS_TOKEN']}"},
    timeout=30,
)
r.raise_for_status()
for e in r.json()["events"]:
    print(e["occurred_at"], e["smtp_code"], e["bounce_category"], e["diagnostic"])

Example response — /overview

{
  "range": "7d",
  "from": "2026-07-28T19:00:00.000Z",
  "to": "2026-08-04T19:00:00.000Z",
  "totals": {
    "injected": 41293811, "delivered": 40510442, "deferred": 612004,
    "bounced": 402118, "opened": 9120344, "clicked": 1044219, "complained": 3122
  },
  "previous": { "delivered": 38911204, "bounced": 448190 },
  "series": [{ "bucket": "2026-07-28", "delivered": 5712001, "bounced": 61224 }]
}

MCP endpoint (Streamable HTTP)

https://bigstats.email/mcp

Client config (Claude Desktop / Cursor style)

{
  "mcpServers": {
    "bigstats": {
      "url": "https://bigstats.email/mcp"
    }
  }
}