Reporting

Analytics

Real-time and historical delivery and engagement analytics. Track open rates, click rates, bounces, and complaints.

Available Metrics

Metric	Description
`sent`	Total messages accepted for delivery
`delivered`	Messages that reached the recipient server
`opened_unique`	Unique opens (first open per recipient)
`clicked_unique`	Unique link clicks
`bounced`	Hard and soft bounces combined
`complained`	Spam complaints (FBL)
`unsubscribed`	Unsubscribe clicks

Derived Rates

delivery_rate = delivered / sent
open_rate = opened_unique / delivered
click_rate = clicked_unique / delivered
bounce_rate = bounced / sent
complaint_rate = complained / delivered

Stats API

curl https://api.postmta.com/v1/analytics/stats -H "Authorization: Bearer pmta_live_xxxx"
curl "https://api.postmta.com/v1/analytics/stats?domain=mail.example.com" -H "Authorization: Bearer pmta_live_xxxx"

Time Series Data

curl "https://api.postmta.com/v1/analytics/timeseries?granularity=day" -H "Authorization: Bearer pmta_live_xxxx"

{"data":[{"date":"2026-01-01","sent":3200,"delivered":3150,"opened":980,"clicked":210,"bounced":50}]}

Domain Breakdown

curl https://api.postmta.com/v1/analytics/breakdown/domains -H "Authorization: Bearer pmta_live_xxxx"

Exporting Data

curl "https://api.postmta.com/v1/analytics/export?format=csv" -H "Authorization: Bearer pmta_live_xxxx" -o analytics.csv