> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Analytics Summary

> Account-wide mail performance totals plus per-campaign engagement

Get account-wide mail analytics in a single call: totals across every campaign (sent, delivered, failed, opens, unique openers, average open rate) plus a paginated list of campaigns with their individual engagement stats. Open metrics are derived from QR/link scans on your mailers.

<ParamField query="start_date" type="string">
  Start of the date range (ISO, e.g. `2026-05-01`). Filters campaigns by launch date.
</ParamField>

<ParamField query="end_date" type="string">
  End of the date range (ISO, inclusive).
</ParamField>

<ParamField query="launched_only" type="boolean" default="false">
  Only include campaigns that have been launched.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number for the campaigns list.
</ParamField>

<ParamField query="per_page" type="integer" default="25">
  Results per page (1–100).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.v2.dealmachine.com/v1/mail/analytics/summary?start_date=2026-05-01&end_date=2026-05-31" \
    -H "Authorization: Bearer dm_sk_live_xxx"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "summary": {
        "total_sent": 1240,
        "total_delivered": 1180,
        "total_failed": 22,
        "total_opened": 410,
        "unique_openers": 295,
        "avg_open_rate": 0.238,
        "campaign_count": 6
      },
      "campaigns": [
        {
          "campaign_id": "a1b2c3d4",
          "campaign_name": "Spring Seller Campaign",
          "status": "Completed",
          "total_sent": 300,
          "total_delivered": 286,
          "total_failed": 5,
          "total_opened": 96,
          "unique_openers": 71,
          "open_rate": 0.237,
          "created_at": "2026-05-01T14:30:00.000Z",
          "launched_at": "2026-05-02T09:00:00.000Z"
        }
      ]
    },
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 6,
      "has_more": false
    }
  }
  ```
</ResponseExample>