Terug naar overzichtEen eigen dashboard bouwen, statistieken delen met je webbureau klanten of verwerken in je eigen SaaS (Software as a Service)? Vanaf vandaag kun je e-mailstatistieken opvragen via de stats API, een nieuw endpoint binnen de Team API.
Met de Stats API heb je direct toegang tot:
- Totaal verzonden, afgeleverd, soft bounced en hard bounced
- Opens en clicks
- Spam complaints
- Statistieken per dag
- Statistieken per project
- Onderscheid tussen transactional e-mails, broadcast e-mails en inbound e-mails
Hoe werkt het?
De stats API is onderdeel van de Team API. Om het endpoint te gebruiken heb je een Team API token nodig. Die kun je aanmaken in de instellingen van je team.
Je roept het /v1/stats endpoint aan met een periode. Wanneer je een project_id meegeeft, ontvang je statistieken op projectniveau. Laat je dit weg, dan krijg je een overzicht van je hele team. De maximale periode is 90 dagen.
Je ontvangt statistieken als totaal én uitgesplitst per dag:
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
}
}
]
}
Beschikbaarheid
De stats API is beschikbaar voor alle abonnementen, inclusief het gratis plan. Bekijk de volledige documentatie voor alle beschikbare parameters en mogelijkheden in de stats API documentatie.