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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

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

sending_domain_ids[]integer · int64[]Optional

IDs of the sending domains for which to include the results. If not provided, results for all sending 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

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/stats

cURLRuby

curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

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

sending_domain_ids[]integer · int64[]Optional

IDs of the sending domains for which to include the results. If not provided, results for all sending 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

sending_domain_idinteger · int64OptionalExample: 3938

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/stats/domains

cURLRuby

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

[
  {
    "sending_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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

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

sending_domain_ids[]integer · int64[]Optional

IDs of the sending domains for which to include the results. If not provided, results for all sending 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

categorystringOptionalExample: Welcome Email

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/stats/categories

cURLRuby

curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

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

sending_domain_ids[]integer · int64[]Optional

IDs of the sending domains for which to include the results. If not provided, results for all sending 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

email_service_providerstringOptionalExample: Google

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/stats/email_service_providers

cURLRuby

curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

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

sending_domain_ids[]integer · int64[]Optional

IDs of the sending domains for which to include the results. If not provided, results for all sending 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

datestring · dateOptionalExample: 2025-01-01

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/stats/date

cURLRuby

curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/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
    }
  }
]