Analytics

Get analytics

Sending and deliverability totals for the account, plus a 30-day daily series. Pass days and/or domain to add a window object holding exact counts for that window and sending domain, aggregated in the database rather than sampled from the event log.

get/v1/analytics

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/analytics
  • Auth: HTTP bearer

Query parameters

daysinteger

Window in days (1-90) for the window block. Present in the response only when days or domain is given.

domainstring

Restrict the window block to one sending domain, by name or id.

Response

Analytics data

totalinteger

Every email on the account, whatever its status

sentinteger

Emails that went out (sent, delivered, opened, clicked, bounced or complained). The rates are worked out against this.

todayinteger

Emails sent in the last 24 hours

thisWeekinteger

Emails sent in the last 7 days

deliveredinteger

Accepted by the receiving server, including those later opened or clicked

bouncedinteger
complainedinteger
failedinteger

Never sent because of an error

pendinginteger

Scheduled, queued or sending; not counted in any rate yet

canceledinteger
awaitingReportinteger

Sent, with no delivery or bounce report yet; not counted in the rates

deliveryRatenumber float

(delivered + complained) / (sent - awaitingReport), as a percentage

bounceRatenumber float

bounced / (sent - awaitingReport), as a percentage

Example response

{
  "total": 24707,
  "sent": 24190,
  "today": 312,
  "thisWeek": 2190,
  "delivered": 23610,
  "bounced": 402,
  "complained": 11,
  "failed": 157,
  "pending": 320,
  "canceled": 40,
  "awaitingReport": 167,
  "deliveryRate": 98.3,
  "bounceRate": 1.7,
  "daily": [
    {
      "date": "2026-08-22",
      "sent": 780,
      "delivered": 761,
      "bounced": 12
    }
  ],
  "usage": {
    "period": "2026-09",
    "sent": 8420,
    "delivered": 8201,
    "bounced": 140,
    "limit": 50000,
    "tier": "pro"
  },
  "window": {
    "days": 7
  }
}

Changes

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