Stats

Email sending stats

Email sending aggregated stats. The same you see in your Stats dashboard.

Get Sending Stats

get

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

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

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
}

Get Sending Stats by Domains

get

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

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

application/json

domain_idinteger · int64OptionalExample: 3938

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/domains

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

[
  {
    "domain_id": 3938,
    "stats": {
      "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
    }
  }
]

Get Sending Stats by Categories

get

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

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

application/json

categorystringOptionalExample: Welcome Email

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/categories

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

[
  {
    "category": "Welcome Email",
    "stats": {
      "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
    }
  }
]

Get Sending Stats by Email Service Providers

get

Get account sending stats by email service providers. Use filters to get specific stats.

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

application/json

email_service_providerstringOptionalExample: Google

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/email_service_providers

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

[
  {
    "email_service_provider": "Google",
    "stats": {
      "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
    }
  }
]

Get Sending Stats by Date

get

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

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

application/json

datestring · dateOptionalExample: 2025-01-01

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/date

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

[
  {
    "date": "2025-01-01",
    "stats": {
      "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
    }
  }
]

PreviousTracking Opt-Outs NextEmail Logs

Last updated 2 hours ago

Was this helpful?