Skip to content
/
Query account usage metri...

Query account usage metrics

Request

Queries filtered usage metrics for an account

Security
basicAuth
Body
required
startstring

A start date (default: 7 days before current time). Must be in RFC 2822 format: https://datatracker.ietf.org/doc/html/rfc2822.html#page-14

endstring

An end date (default: current time). Must be in RFC 2822 format: https://datatracker.ietf.org/doc/html/rfc2822.html#page-14

resolutionstring

A resolution in the format of 'day' 'hour' 'month'. Default is day.

durationstring

A duration in the format of '1d' '2h' '2m'. If duration is provided then it is calculated from the end date and overwrites the start date.

dimensionsArray of strings

Attributes of the metric data such as 'subaccount'. See dimensions

metricsArray of strings

Name of the metrics to receive the stats for such as 'processed_count'.

filterobject(github.com-mailgun-analytics-client-golang-FilterPredicateGroup)

Filters to apply to the query.

include_subaccountsboolean

Include stats from all subaccounts.

include_aggregatesboolean

Include top-level aggregate metrics.

curl -i -X POST \
  -u '<username>:<password>' \
  https://api.mailgun.net/v1/analytics/usage/metrics \
  -H 'Content-Type: application/json' \
  -d '{
    "start": "Mon, 13 Nov 2023 20:56:50 -0600",
    "end": "Wed, 20 Dec 2023 20:56:50 -0600",
    "resolution": "month",
    "duration": "1m",
    "dimensions": [
      "time"
    ],
    "metrics": [
      "accessibility_count",
      "accessibility_failed_count",
      "archived_count",
      "domain_blocklist_monitoring_count",
      "email_preview_count",
      "email_preview_failed_count",
      "email_validation_bulk_count",
      "email_validation_count",
      "email_validation_list_count",
      "email_validation_mailgun_count",
      "email_validation_mailjet_count",
      "email_validation_public_count",
      "email_validation_single_count",
      "email_validation_valid_count",
      "image_validation_count",
      "image_validation_failed_count",
      "spam_content_check_count",
      "spam_content_check_failed_count",
      "ip_blocklist_monitoring_count",
      "link_validation_count",
      "link_validation_failed_count",
      "processed_count",
      "seed_test_count"
    ],
    "filter": {
      "AND": [
        {
          "attribute": "subaccount",
          "comparator": "=",
          "values": [
            {
              "label": "12345",
              "value": "12345"
            }
          ]
        }
      ]
    },
    "include_subaccounts": true,
    "include_aggregates": true
  }'

Responses

A 200 response

Bodyapplication/json
startstring
endstring
resolutionstring
durationstring
dimensionsArray of strings
paginationobject(github.com-mailgun-analytics-client-golang-Pagination)
itemsArray of objects(github.com-mailgun-analytics-internal-api-UsageItem)required
aggregatesobject(github.com-mailgun-analytics-internal-api-UsageAggregates)
Response
{
  "start": "Mon, 13 Nov 2023 20:56:50 -0600",
  "end": "Wed, 20 Dec 2023 20:56:50 -0600",
  "resolution": "month",
  "duration": "1m",
  "pagination": {
    "sort": "timestamp:asc",
    "skip": 1,
    "limit": 10,
    "total": 1000
  },
  "items": [
    { … },
    { … }
  ],
  "aggregates": {
    "metrics": {}
  }
}