New: the MailCraft MCP server is live — connect your AI agent in one line. Connect your agent →
Start free
API reference

Metrics & reputation

Time-series send metrics and a rolling sending-reputation score based on bounce and complaint rate.

Get email metrics

Daily sent/delivered/opened/clicked/bounced/complained counts. Defaults to the last 30 days; pass `start_date`/`end_date` (`YYYY-MM-DD`) to narrow the range.

GET
/metrics

Authorizations

Authorization
string
header
required

API key for your workspace, scoped to emails:send. Pass it as a Bearer token in the Authorization header.

Get email metrics
curl https://api.mailcraft.host/v1/metrics?start_date=2026-09-01&end_date=2026-09-22 \
  -H 'Authorization: Bearer sk_live_...'
{
  "data": [
    { "date": "2026-09-22", "sent": 412, "delivered": 404, "opened": 201, "clicked": 44, "bounced": 3, "complained": 0 }
  ],
  "totals": { "sent": 412, "delivered": 404, "opened": 201, "clicked": 44, "bounced": 3, "complained": 0 },
  "period": { "start_date": "2026-09-01", "end_date": "2026-09-22" }
}

Get sending reputation

Rolling 7-day bounce and complaint rate against the same thresholds SES uses to flag an account as at-risk.

GET
/reputation

Authorizations

Authorization
string
header
required

API key for your workspace, scoped to emails:send. Pass it as a Bearer token in the Authorization header.

Get sending reputation
curl https://api.mailcraft.host/v1/reputation \
  -H 'Authorization: Bearer sk_live_...'
{
  "data": {
    "status": "good",
    "bounce_rate": 0.0073,
    "complaint_rate": 0.0,
    "sample_size": 412,
    "window_days": 7
  }
}