Deliverability API

Best-effort deliverability insights computed from the email rows and webhook events SuperSend TX already stores.

Base URL: https://api.supersendtx.com

Auth:

Authorization: Bearer stx_...

Get insights

GET /deliverability?window=30d

Supported windows:

7d
30d (default)

Example:

curl -X GET "https://api.supersendtx.com/deliverability?window=7d" \
  -H "Authorization: Bearer $SUPERSENDTX_API_KEY"

Response:

{
  "window": "7d",
  "window_start": "2026-07-19T00:00:00.000Z",
  "generated_at": "2026-07-26T00:00:00.000Z",
  "summary": {
    "total_emails": 10,
    "attempted": 9,
    "sent": 8,
    "delivered": 7,
    "bounced": 1,
    "failed": 1,
    "suppressed": 1,
    "scheduled": 0,
    "opened": 3,
    "clicked": 1,
    "bounce_rate": 0.1111,
    "delivery_rate": 0.7778,
    "open_rate": 0.4286,
    "click_rate": 0.1429
  },
  "by_domain": [],
  "top_bounce_reasons": [],
  "notes": [
    "Best-effort metrics only"
  ]
}

What this includes

attempted vs scheduled/suppressed counts
delivered and bounced counts
best-effort open/click counts from stored events
breakdown by sending domain
top recorded bounce reasons

Roadmap

These are not exposed in the API yet:

inbox placement / spam folder data
provider reputation and reputation trends
richer bounce classifications beyond stored events

SDK

const insights = await client.emails.insights('30d')

CLI

supersendtx emails insights --window 7d