---
title: "GET an Email Campaign Stats Report"
method: GET
path: "/reports/stats/email_campaigns/{campaign_ids}"
tags: ["Email Reporting"]
---

# GET an Email Campaign Stats Report

`GET /reports/stats/email_campaigns/{campaign_ids}`

Use this method to get email campaign performance tracking statistics for one or more campaigns, including the total number of times contacts interacted with your campaigns and how.

For each `campaign_id`, this method returns lists that include total counts (`stats`) for each type of tracked email and relevant campaign-related percentages (`percents`). It also returns the date and time at which the campaign stats were last refreshed.
If any specified `campaign_id` is invalid, a 404 error response is returned for all campaigns.

## Path parameters

- `campaign_ids` string, required

## Response `200`

Request was successful.

- CampaignStatsQueryResultEmail
  - `errors` StatsError[] — An array of errors indicating any partial failures in the query.
    - `error_key` string — The unique error key.
    - `error_message` string — A error description.
  - `results` CampaignStatsResultGenericStatsEmailPercentsEmail[] — An array of results listing statistics for each requested <code>campaign_id</code>.
    - `campaign_id` string — The ID that uniquely identifies the campaign (UUID).
    - `stats` StatsEmail
      - `em_bounces` integer — Number of unique email bounces.
      - `em_clicks` integer — Number of unique recipients who clicked any link in the email.
      - `em_clicks_all` integer — Total number of non-unique email clicks.
      - `em_clicks_all_computer` integer — Number of non-unique email clicks on a standard desktop or laptop computer.
      - `em_clicks_all_mobile` integer — Number of non-unique email clicks on a mobile phone or similar small mobile device (e.g. iPhone).
      - `em_clicks_all_tablet` integer — Number of non-unique email clicks on a small tablet type computer (e.g. iPad).
      - `em_clicks_all_other` integer — Number of non-unique email clicks on an unknown device (e.g. Game Console or Wearable).
      - `em_clicks_all_none` integer — Number of non-unique email clicks for which the device type was not captured. This will account for any clicks prior to when device type was collected and stored.
      - `em_forwards` integer — Number of unique recipients who forwarded the email using the forward to a friend feature (not available for all types of emails).
      - `em_not_opened` integer — Number of unique recipients who did not open the email. This is calculated as follows: <code>em_not_opened</code> is equal to <code>em_sends - em_opens - em_bounces</code>. This value is reported as zero if the calculation results in a negative value.
      - `em_opens` integer — Number of unique recipients who opened the email.
      - `em_opens_all` integer — Total number of non-unique email opens.
      - `em_opens_all_computer` integer — Number of non-unique email opens on a standard desktop or laptop computer.
      - `em_opens_all_mobile` integer — Number of non-unique email opens on a mobile phone or similar small mobile device (e.g. iPhone).
      - `em_opens_all_tablet` integer — Number of non-unique email opens on a small tablet type computer (e.g. iPad).
      - `em_opens_all_other` integer — Number of non-unique email opens on an unknown device (e.g. Game Console or Wearable).
      - `em_opens_all_none` integer — Number of non-unique email opens for which the device type was not captured. This will account for any opens prior to when device type was collected and stored.
      - `em_optouts` integer — Number of unique recipients who unsubscribed due to this email.
      - `em_sends` integer — Number of unique email sends.
    - `percents` PercentsEmail
      - `bounce` number — Percentage of emails sent to unique recipients that bounced.
      - `click` number — Percentage of recipients who opened the email who also clicked one or more links in it.
      - `desktop_click` number — Percentage of clicks that came from a standard desktop or laptop computer.
      - `desktop_open` number — Percentage of opens that came from a standard desktop or laptop computer.
      - `did_not_open` number — Percentage of recipients that received the email (did not bounce) but did not open it.
      - `mobile_click` number — Percentage of clicks that came from a mobile phone, tablet computer, or similar small mobile device (e.g. iPhone or iPad).
      - `mobile_open` number — Percentage of opens that came from a mobile phone, tablet computer, or similar small mobile device (e.g. iPhone or iPad).
      - `open` number — Percentage of recipients that received the email (did not bounce) and opened it.
      - `unsubscribe` number — Percentage of recipients that received the email (did not bounce) and chose to unsubscribe.
    - `last_refresh_time` string, date-time — The date and time that the campaign stats were last refreshed.

## 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.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)