---
title: "Retrieve broadcast stats"
method: GET
path: "/broadcasts/{id}/stats"
tags: ["Broadcasts"]
---

# Retrieve broadcast stats

`GET /broadcasts/{id}/stats`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/broadcasts/{id}/stats`
- Auth: API key in header `Authorization`

Returns delivery and engagement stats for a single broadcast. The same object is embedded as `stats` on the broadcast itself; this endpoint exists for callers that only want to poll progress.

## Path parameters

- `id` string, required

## Response `200`

Broadcast stats

- BroadcastStats: Delivery and engagement rollup for a broadcast. Rates are fractions of `sent` (a recipient never handed to the provider can't have opened anything).
  - `object` 'broadcast_stats', required
  - `broadcast` string, required: The broadcast's prefixed id.
  - `recipients` integer, required: Size of the resolved audience.
  - `sent` integer, required: Handed to the email provider.
  - `delivered` integer, required
  - `bounced` integer, required
  - `complained` integer, required: Marked as spam by the recipient.
  - `failed` integer, required
  - `opened` integer, required: Distinct recipients who opened.
  - `clicked` integer, required: Distinct recipients who clicked a link.
  - `unsubscribed` integer, required
  - `delivery_rate` number, required
  - `open_rate` number, required
  - `click_rate` number, required
  - `bounce_rate` number, required
  - `unsubscribe_rate` number, required
  - `progress` number, required: Percentage of the audience already handed to the provider.
  - `status` 'draft' | 'scheduled' | 'sending' | 'sent' | 'canceled' | 'failed', required

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)