LettermintLettermint
  • Knowledge base
  • Community
  • Changelog
  • Support
  • Documentation
  • Sending API
  • Team API
  • MCP server
Information
Core
    Generic
      Ping the APIgetList blocked file typesget
    Team
      Get team detailsgetUpdate team settingsputGet team usage statisticsgetGet reusable team rolesgetGet team membersgetGet a team membergetReplace a team member's assignmentput
    Stats
      Get message statisticsget
Email Platform
    Domain
      List all domains for the teamgetCreate a new domainpostGet domain detailsgetDelete a domaindeleteVerify all DNS records for a domainpostVerify a specific DNS recordpostUpdate projects associated with a domainput
    Project
      List all projects for the teamgetCreate a new projectpostGet project detailsgetUpdate project settingsputDelete a projectdeleteRotate Project API token (legacy)postList routes for a projectgetCreate a new routepostGet route detailsgetUpdate route settingsputDelete a routedeleteVerify inbound domain for a routepost
    Webhook
      List all webhooks for the teamgetCreate a new webhookpostGet webhook detailsgetUpdate webhook settingsputDelete a webhookdeleteTest a webhook by sending a sample payloadpostRegenerate webhook secretpostGet webhook deliveriesgetGet a specific webhook deliveryget
    Message
      Get message detailsgetChange the delivery time of a pending scheduled messagepatchCancel a pending scheduled message. Cancellation is finalpostList messages for the teamgetGet message eventsgetGet message sourcegetGet message HTML contentgetGet message plain text contentgetProcess one quarantined inbound messagepost
    Suppression
      List all suppressions for the teamgetAdd email(s) to suppression listpostRemove email from suppression listdelete
Schemas
Lettermint Team API
Lettermint Team API

Stats

Download schema

Retrieve aggregated sending statistics for your team across a period.


Get message statistics

GET
https://api.lettermint.co/v1
/stats
Bearer

Returns aggregate message statistics for the specified date range. Provide a project_id to get per-project stats with transactional/broadcast breakdown. Without project_id, returns team-wide totals from team_message_stats. Maximum date range is 90 days.

Get message statistics › query Parameters

from
​string · date · required

Start date (Y-m-d)

to
​string · date · required

End date (Y-m-d, maximum 90 days from from)

project_id
​string | null · uuid

Optional project UUID for project-scoped statistics with transactional and broadcast breakdowns

include_machine
​boolean

Include legacy machine observations in open and click totals. Privacy opens are reported in the observed and privacy fields without this option

Default: false

Get message statistics › Headers

Authorization
​string · required

Bearer token. Format: Bearer {team_token}

Get message statistics › Responses

StatsData

StatsData
from
​string · required
to
​string · required
​StatsTotalsData · required
​StatsDailyData[] · required
GET/stats
curl 'https://api.lettermint.co/v1/stats?from=<string>&to=<string>' \ --header 'Authorization: Bearer <token>'
Example Responses
{ "from": "from", "to": "to", "totals": { "sent": 0, "delivered": 0, "hard_bounced": 0, "spam_complaints": 0, "opened": 0, "clicked": 0, "inbound": { "received": 0 }, "transactional": { "sent": 0, "hard_bounced": 0, "spam_complaints": 0 }, "broadcast": { "sent": 0, "hard_bounced": 0, "spam_complaints": 0 }, "observed_opened": 0, "human_opened": 0, "privacy_opened": 0, "effective_opened": 0, "machine_opened": 0, "machine_clicked": 0 }, "daily": [ { "date": "date", "sent": 0, "delivered": 0, "hard_bounced": 0, "spam_complaints": 0, "opened": 0, "clicked": 0, "inbound": { "received": 0 }, "transactional": { "sent": 0, "hard_bounced": 0, "spam_complaints": 0 }, "broadcast": { "sent": 0, "hard_bounced": 0, "spam_complaints": 0 }, "observed_opened": 0, "human_opened": 0, "privacy_opened": 0, "effective_opened": 0, "machine_opened": 0, "machine_clicked": 0 } ] }
json
application/json

TeamDomain