---
title: "Get email campaign statistics"
method: GET
path: "/stats"
tags: ["Email campaigns (legacy)"]
deprecated: true
---

# Get email campaign statistics

`GET /stats`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/stats`
- Auth: API key in header `Authorization`

> **Deprecated.**

Returns aggregated statistics for one email campaign. By default (detailed omitted or not 'true') a flat summary is returned; with detailed=true a { global, steps } breakdown is returned. Statistics are computed on demand and cached. PITFALLS: when the campaign is not found the route answers 401 (not 404) with { error: 'Campaign not found' }; ANY internal error also answers 401 { error: 'You must be logged in' }. detailed is read as the string 'true'; any other value (including the boolean true serialised elsewhere) is treated as the summary. New integrations should use the multichannel /advanced campaign endpoints instead.

## Query parameters

- `campaignId` string, required
- `detailed` boolean
- `start` string
- `end` string
- `providerId` string

## Response `200`

Summary (default) or detailed stats.

- union
  - LegacyEmailStatsSummary: Flat email stats summary (detailed omitted).
    - `mailsSent` integer
    - `uniqueOpensPercent` number
    - `opens` integer
    - `linkClickedPercent` number
    - `repliedPercent` number
    - `bouncedPercent` number
    - `unsubscribePercent` number
    - `progressPercent` number
  - LegacyStatsDetailed: Detailed stats (detailed=true): global totals plus a per-step, per-version breakdown.
    - `global` object
    - `steps` array[]
      - object[]

## Other responses

- `401`: Campaign not found, or any internal/auth error (this route returns 401 for both).
- `503`: Statistics are still being computed (only for accounts under single-flight), retry after the Retry-After delay.

---

[API](https://skmtc.dev/emelia/apis/emelia-api.md) · [All operations](https://skmtc.dev/emelia/apis/emelia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emelia/apis/emelia-api/revisions/8c0cb435f2c4?raw)