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

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

cURL

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

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

cURL

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

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

cURL

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

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

cURL

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

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

cURL

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
      }
    ]
  }
]