# Metrics

The Mailgun Metrics API provides programmatic access to detailed analytics data about your email sending activity. This API allows you to query, filter, and analyze email performance metrics to gain insights into deliverability, engagement, and overall sending health.

 - [Metrics vs. Stats API](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/metrics-vs.-stats-api.md): ## Metrics vs. Stats API The Metrics API is the modern replacement for the deprecated Stats API: | Feature | Stats API (Deprecated) | Metrics API (Current) | | --- | --- | --- | | Flexibility | Limit
 - [What Are Metrics?](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/what-are-metrics.md): ## What Are Metrics? Metrics are quantitative measurements of your email activity. The Mailgun platform collects event data in real-time and aggregates it into meaningful metrics that help you underst
 - [Types of Metrics](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/types-of-metrics.md): ## Types of Metrics Mailgun provides two categories of metrics:
 - [Sending Metrics (via ](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/sending-metrics-(via.md): ### Sending Metrics (via `/v1/analytics/metrics`) These metrics track the lifecycle and performance of your outbound emails: - **Volume Metrics**: Messages accepted, delivered, failed, queued - **Enga
 - [Usage Metrics (via ](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/usage-metrics-(via.md): ### Usage Metrics (via `/v1/analytics/usage/metrics`) These metrics track your consumption of Mailgun services and features: - **Email Validation**: Single validations, bulk validations, API calls - *
 - [Core Concepts](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/core-concepts.md): ## Core Concepts
 - [Dimensions](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/dimensions.md): ### Dimensions Dimensions are the attributes by which you can slice and group your metrics data. Think of them as the "categories" or "labels" for your data. **Available Dimensions:** See [dimensions]
 - [Resolution](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/resolution.md): ### Resolution Resolution determines the time granularity of your results: - **hour**: Data grouped by hour (useful for real-time monitoring) - **day**: Data grouped by day (most common for daily repo
 - [Time Range Selection](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/time-range-selection.md): ### Time Range Selection You have flexible options for specifying the time range: **Option 1: Start and End Dates** ```json { "start": "Mon, 13 Nov 2023 00:00:00 -0600", "end": "Mon, 20 Nov 2023 23:5
 - [Filters](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/filters.md): ### Filters Filters allow you to narrow down your data to specific criteria. The filter system uses a logical structure: ```json { "filter": { "AND": [ { "attribute": "domain", "com
 - [Aggregates](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/aggregates.md): ### Aggregates When `include_aggregates` is set to `true`, the API returns top-level summary statistics across all your queried data. This gives you totals and averages without having to sum the indiv
 - [Subaccounts](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/subaccounts.md): ### Subaccounts If you use Mailgun's subaccount feature, you can: - Query metrics for a specific subaccount using filters - Include all subaccounts' data with `include_subaccounts: true` - View aggreg
 - [Data Retention](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/data-retention.md): ## Data Retention Mailgun retains metrics data for different durations based on resolution: - **Hourly**: 60 days - **Daily**: 1 year - **Monthly**: Indefinitely
 - [Pagination](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/pagination.md): ## Pagination For queries that return large result sets, the API uses offset-based pagination with `skip` and `limit` request attributes. - `skip` specifies how many items to offset (skip) from the be
 - [Rate Limits and Quotas](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/rate-limits-and-quotas.md): ## Rate Limits and Quotas - API calls are subject to a rate limit of 500 requests every 10 seconds
 - [POST /v1/analytics/metrics](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/post-v1-analytics-metrics.md): Queries filtered metrics for an account
 - [POST /v1/analytics/usage/metrics](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/metrics/post-v1-analytics-usage-metrics.md): Queries filtered usage metrics for an account