---
title: "GET an Email Campaigns Summary Report"
method: GET
path: "/reports/summary_reports/email_campaign_summaries"
tags: ["Email Reporting"]
---

# GET an Email Campaigns Summary Report

`GET /reports/summary_reports/email_campaign_summaries`

## Request

- Base URL: `https://api.cc.email/v3`
- URL: `https://api.cc.email/v3/reports/summary_reports/email_campaign_summaries`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://authz.constantcontact.com/oauth2/default/v1/authorize`
    - Scopes: `campaign_data`
  - OAuth 2
    - Authorization code: `https://authz.constantcontact.com/oauth2/default/v1/authorize`
    - Token URL: `https://authz.constantcontact.com/oauth2/default/v1/token` scopes: `campaign_data`
- TypeScript: <https://skmtc.dev/cc/apis/appconnect-v3/docs/reports/summary_reports/email_campaign_summaries/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this method to get aggregate email campaign statistics for up to five hundred email campaigns. The response results include the total number of times that each contact uniquely interacted with each tracked campaign activity.

Results are sorted in descending order by the date that the email was last sent (<code>last_sent_date</code>). Use the <code>limit</code> query parameter to limit the number of email campaign summary reports listed on each page.



 For more use case information, see "[Get an Email Campaign Summary Report](/api_guide/email_bulk_campaign_summary_report.html)"

## Query parameters

- `limit` string

## Response `200`

Request was successful.

- BulkEmailCampaignSummariesPage
  - `bulk_email_campaign_summaries` BulkEmailCampaignSummary[]: Lists and provides details about each bulk email campaign activity including total unique counts for tracked activities.
    - `campaign_id` string, required: The ID that uniquely identifies an email campaign.
    - `campaign_type` string: Identifies the email campaign type.
    - `last_sent_date` string, date-time: The date and time that the email campaign was last sent.
    - `unique_counts` UniqueEmailCounts
      - `sends` integer: The total number of unique sends.
      - `opens` integer: The total number of unique opens.
      - `clicks` integer: The total number of unique clicks.
      - `forwards` integer: The total number of unique forwards.
      - `optouts` integer: The total number of unique optouts (unsubscribes).
      - `abuse` integer: The total number of unique abuse count (spam).
      - `bounces` integer: The total number of unique bounce count.
      - `not_opened` integer: The total number of unique non-opens
  - `aggregate_percents` BulkEmailCampaignSummariesPercents
    - `click` number: Aggregated click rate for campaigns on the current page.
    - `open` number: Aggregated open rate for campaigns on the current page.
    - `did_not_open` number: Aggregated did-not-open rate for campaigns on the current page.
    - `bounce` number: Aggregated bounce rate for campaigns on the current page.
    - `unsubscribe` number: Aggregated unsubscribe (optout) rate for campaigns on the current page.
  - `_links` ReportingLinks
    - `next` ReportingNext
      - `href` string: The next link in the page or null if there are no additional pages.

## Other responses

- `400`: Bad request. Either the JSON was malformed or there was a data validation error.
- `401`: The Access Token used is invalid.
- `403`: Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404`: The requested resource was not found.
- `500`: There was a problem with our internal service.

## Changes

- **2025-07-26** `2483585c5d89`: 1 info
  - the endpoint scheme security `api_key` was removed from the API
- **2021-07-20** `f1d4ed59fcf2`: 4 info
  - the security scope `campaign_data` was added to the endpoint's security scheme `oauth2_access_code`
  - the security scope `campaign_data` was added to the endpoint's security scheme `oauth2_implicit`
  - the security scope `contact_data` was removed from the endpoint's security scheme `oauth2_access_code`
  - the security scope `contact_data` was removed from the endpoint's security scheme `oauth2_implicit`
- **2021-01-27** `d9ba9fa44622`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cc/apis/appconnect-v3/changes/reports/summary_reports/email_campaign_summaries/get.md)

---

[API](https://skmtc.dev/cc/apis/appconnect-v3.md) - [All operations](https://skmtc.dev/cc/apis/appconnect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/cc/apis/appconnect-v3/revisions/3e70cd1906c2?raw)