Back to overviewBuild your own dashboard, share statistics with your agency clients or process them in your own SaaS (Software as a Service)? Starting today, you can retrieve email statistics via the stats API, a new endpoint within the Team API.
With the stats API you have direct access to:
- Total sent, delivered, soft bounced and hard bounced
- Opens and clicks
- Spam complaints
- Statistics per day
- Statistics per project
- Breakdown between transactional emails, broadcast emails and inbound emails
How does it work?
The stats API is part of the Team API. To use the endpoint you need a Team API token. You can create one in your team settings.
Call the /v1/stats endpoint with a time period. When you include a project_id, you receive statistics at project level. Leave it out to get an overview of your entire team. The maximum period is 90 days.
You receive statistics as a total and broken down per day:
curl --request GET \
--url 'https://api.lettermint.co/v1/stats?from=2026-03-01&to=2026-03-28' \
--header 'Authorization: Bearer <token>'
{
"from": "2026-03-01",
"to": "2026-03-28",
"totals": {
"sent": 4821,
"delivered": 4743,
"hard_bounced": 12,
"spam_complaints": 2,
"opened": 1893,
"clicked": 412,
"inbound": {
"received": 143
},
"transactional": {
"sent": 3210,
"hard_bounced": 8,
"spam_complaints": 1
},
"broadcast": {
"sent": 1611,
"hard_bounced": 4,
"spam_complaints": 1
}
},
"daily": [
{
"date": "2026-03-01",
"sent": 178,
"delivered": 175,
"hard_bounced": 1,
"spam_complaints": 0,
"opened": 68,
"clicked": 14,
"inbound": {
"received": 5
}
}
]
}
Availability
The stats API is available on all plans, including the free plan. Check the full documentation for all available parameters and options in the stats API documentation.