Get Sending Stats

Get account sending stats. Use filters to get specific stats.

get

Authorizations

Api-TokenstringRequired

API token in Api-Token header

Query parameters

start_datestring · dateRequired

Start date for which to include the results.

Example: 2025-01-01

end_datestring · dateRequired

End date for which to include the results.

Example: 2025-12-31

domain_ids[]integer · int64[]Optional

IDs of the domains for which to include the results. If not provided, results for all domains will be included.

Example: [3938,3939]

categories[]string[]Optional

Categories for which to include the results. If not provided, results for all categories will be included.

Example: ["Welcome Email","Password Reset"]

Responses

200

OK

application/json

delivery_countintegerOptionalExample: 190

delivery_ratenumber · doubleOptionalExample: 0.95

bounce_countintegerOptionalExample: 10

bounce_ratenumber · doubleOptionalExample: 0.05

open_countintegerOptionalExample: 171

open_ratenumber · doubleOptionalExample: 0.9

click_countintegerOptionalExample: 133

click_ratenumber · doubleOptionalExample: 0.7

spam_countintegerOptionalExample: 3

spam_ratenumber · doubleOptionalExample: 0.02

400

Bad request - invalid parameters.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get/api/stats

curl -X GET 'https://mailtrap.io/api/stats?start_date=2025-01-01&end_date=2025-12-31' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "delivery_count": 190,
  "delivery_rate": 0.95,
  "bounce_count": 10,
  "bounce_rate": 0.05,
  "open_count": 171,
  "open_rate": 0.9,
  "click_count": 133,
  "click_rate": 0.7,
  "spam_count": 3,
  "spam_rate": 0.02
}