Emails

Email deliverability stats

Retrieve aggregate deliverability and engagement metrics for your workspace over a rolling window. You get totals (sent, delivered, opened, clicked, bounced, complained, failed) alongside the rates that matter — delivery, open, click, bounce, and complaint. Open and click rates count only emails where that tracking was enabled, so turning tracking off for transactional mail won't skew them. Control the window with the days parameter (1–365, default 30). For the individual emails behind these numbers, see List sent emails. Requires the emails:read capability.

get/email/stats

Request

  • Base URL: https://www.unitpost.com/api/v1
  • URL: https://www.unitpost.com/api/v1/email/stats
  • Auth: HTTP bearer

Query parameters

daysinteger

Window size in days (1–365). Defaults to 30; values above 365 are rejected.

Response

The stats for the window.

windowDaysinteger required

The rolling window, in days.

clampedToRetentionDaysinteger nullable

Non-null when the requested window exceeded the plan's log retention and was clamped to this many days (data past the retention horizon is purged).

Changes

No recorded changes to this operation across all 1 revision of this API.