Retour à l'aperçuConstruire votre propre dashboard, partager des statistiques avec vos clients d'agence ou les intégrer dans votre propre SaaS (Software as a Service) ? À partir d'aujourd'hui, vous pouvez récupérer des statistiques e-mails via la stats API, un nouvel endpoint au sein de la Team API.
Avec la stats API, vous avez un accès direct à :
- Total envoyé, délivré, soft bounced et hard bounced
- Opens et clicks
- Spam complaints
- Statistiques par jour
- Statistiques par projet
- Distinction entre e-mails transactional, e-mails broadcast et inbound emails
Comment ça marche ?
La stats API fait partie de la Team API. Pour utiliser l'endpoint, vous avez besoin d'un token Team API. Vous pouvez en créer un dans les paramètres de votre équipe.
Appelez l'endpoint /v1/stats avec une période. Si vous incluez un project_id, vous recevez des statistiques au niveau du projet. Sans ce paramètre, vous obtenez une vue d'ensemble de toute votre équipe. La période maximale est de 90 jours.
Vous recevez des statistiques en total et ventilées par jour :
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
}
}
]
}
Disponibilité
La stats API est disponible pour tous les abonnements, y compris le plan gratuit. Consultez la documentation complète pour tous les paramètres disponibles dans la documentation stats API.