Skip to Content
Docs
API referenceAnalytics

Delivery statistics

GET
/v1/stats

Sends, delivery outcomes and engagement over the last days UTC days, today included. sent counts emails handed to the mail server. Test-mode traffic is excluded.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Query Parameters

days?integer

Window length in days (clamped to 1–90).

Range1 <= value <= 90
Default30

Response Body

Statistics.

application/json
  1. response
window_days?integer
sent?integer
delivered?integer
bounced?integer
complained?integer
opened?integer
clicked?integer
delivered_open_tracked?integer

Delivered messages that carried an open pixel. Transactional mail has none unless the send set track_opens.

delivered_click_tracked?integer

Delivered messages whose links were tracked. Transactional mail has none unless the send set track_clicks.

delivery_rate_pct?number
bounce_rate_pct?number
complaint_rate_pct?number
open_rate_pct?number

opened over delivered_open_tracked, at most 100. Untracked mail isn't counted, since its opens can't be seen.

click_rate_pct?number

clicked over delivered_click_tracked, at most 100.

Example Request
curl -X GET 'https://api.emitd.com/v1/stats'
Example Response
{  "window_days": 0,  "sent": 0,  "delivered": 0,  "bounced": 0,  "complained": 0,  "opened": 0,  "clicked": 0,  "delivered_open_tracked": 0,  "delivered_click_tracked": 0,  "delivery_rate_pct": 0,  "bounce_rate_pct": 0,  "complaint_rate_pct": 0,  "open_rate_pct": 0,  "click_rate_pct": 0}