---
title: "Get campaign stats"
method: GET
path: "/campaigns/email/{campaign_id}/stats/"
tags: ["campaigns"]
---

# Get campaign stats

`GET /campaigns/email/{campaign_id}/stats/`

## Request

- Base URL: `https://api.hive.co/v2`
- URL: `https://api.hive.co/v2/campaigns/email/{campaign_id}/stats/`
- Auth: HTTP bearer

Engagement and revenue stats for a single email campaign. `stats` is null when no stats are available, and `counts`, `rates` and `revenue` are each null until that section is computed.

## Path parameters

- `campaign_id` string, required

## Headers

- `X-Partner-Id` string, required

## Response `200`

- CampaignStatsResponse
  - `campaign_id` string, required
  - `stats_refreshed_at` string, date-time, nullable, required
  - `stats` CampaignStats, required: Explicit, versioned view over the cached stats blob — the raw blob is never passed through, so internal key changes can't break API consumers. Sections the campaign has no cached data for serialize as null.
    - `counts` CampaignEngagementCounts
      - `sent` integer
      - `delivered` integer
      - `opened` integer
      - `clicked` integer
      - `bounced` integer
      - `soft_bounced` integer
      - `spam_complained` integer
      - `unsubscribed` integer
    - `rates` CampaignEngagementRates
      - `delivery_rate` number, double
      - `open_rate` number, double
      - `click_rate` number, double
      - `bounce_rate` number, double
      - `spam_complaint_rate` number, double
      - `unsubscribe_rate` number, double
      - `estimated_non_prefetched_open_rate` number, double
    - `revenue` CampaignRevenue, required
      - `ecommerce` CampaignChannelRevenue
        - `num_orders` integer
        - `total_revenue` number, double
      - `ticketing` CampaignChannelRevenue
        - `num_orders` integer
        - `total_revenue` number, double
      - `total` CampaignChannelRevenue
        - `num_orders` integer
        - `total_revenue` number, double

## Other responses

- `404`: Campaign not found.

---

[API](https://skmtc.dev/hive-co/apis/hive-api.md) - [All operations](https://skmtc.dev/hive-co/apis/hive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hive-co/apis/hive-api/revisions/aa145f089347?raw)