---
title: "Email statistics now available via the Stats API"
description: "Retrieve email statistics via the Lettermint Stats API. View sent emails, bounces, opens and clicks per day or per project."
url: "https://lettermint.co/changelog/email-statistics-now-available-via-the-stats-api"
published: "2026-03-03"
last_updated: "2026-03-03"
---

# Email statistics now available via the Stats API

> Retrieve email statistics via the Lettermint Stats API. View sent emails, bounces, opens and clicks per day or per project.

Build your own dashboard, share statistics with your [agency clients](https://lettermint.co/for/agencies)
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](https://lettermint.co/changelog/team-api-now-in-preview-manage-your-account-via-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](https://lettermint.co/features/transactional-emails), [broadcast emails](https://lettermint.co/features/broadcast-emails) and [inbound emails](https://lettermint.co/features/inbound-emails)

## How does it work?

The stats API is part of the [Team API](https://docs.lettermint.co/api-reference/team/).
To use the endpoint you need a [Team API token](https://dash.lettermint.co/team/api-tokens).
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:

```bash
curl --request GET \
  --url 'https://api.lettermint.co/v1/stats?from=2026-03-01&to=2026-03-28' \
  --header 'Authorization: Bearer <token>'
```

```jsonsimple
{
  "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](https://docs.lettermint.co/api-reference/team/stats/get-message-statistics).
