Analytics

Get aggregate email delivery statistics across your account, servers, and individual streams. All analytics endpoints require JWT Bearer authentication.

Account Overview

GEThttps://api.postject.com/v1/analytics/overview

Returns a high-level summary of email activity across your entire account.

json

{
  "totalSent": 15420,
  "todaySent": 342,
  "delivered": 14890,
  "bounced": 203,
  "failed": 27,
  "queued": 12
}

Stream Statistics

GEThttps://api.postject.com/v1/analytics/streams/:id

Returns delivery statistics for a specific message stream, including complaint and rejection breakdowns.

json

{
  "total": 8450,
  "delivered": 8200,
  "bounced": 120,
  "complained": 15,
  "rejected": 45,
  "failed": 70
}

Server Statistics

GEThttps://api.postject.com/v1/analytics/servers/:id

Returns aggregate delivery statistics across all streams in a server.

json

{
  "total": 12300,
  "delivered": 11950,
  "bounced": 180,
  "failed": 42
}

Usage History

GEThttps://api.postject.com/v1/analytics/usage

Returns your monthly email usage for the last 12 months. Useful for tracking growth and planning capacity.

json

[
  { "month": "2024-01", "count": 4500 },
  { "month": "2024-02", "count": 5200 },
  { "month": "2024-03", "count": 6800 },
  { "month": "2024-04", "count": 7100 }
]