---
title: "One campaign with stats and per-step counts"
method: GET
path: "/campaigns/{id}"
tags: ["Campaigns"]
---

# One campaign with stats and per-step counts

`GET /campaigns/{id}`

## Request

- Base URL: `https://mcp.senders.ai/api/v1`
- URL: `https://mcp.senders.ai/api/v1/campaigns/{id}`
- Auth: HTTP bearer

Scope: campaigns:read

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `data` CampaignDetail, required
    - `id` integer, required
    - `name` string, nullable, required
    - `status` 'active' | 'paused' | 'completed' | 'archived', required
    - `type` 'single_step' | 'multi_step', required
    - `created_at` string, date-time, nullable: ISO 8601, UTC
    - `updated_at` string, date-time, nullable: ISO 8601, UTC
    - `archived_at` string, date-time, nullable: ISO 8601, UTC
    - `stats` CampaignStats, required
      - `prospects` integer
      - `contacted` integer: Prospects sent at least one email
      - `sent` integer: Emails that left; our replies not counted
      - `delivered` integer: sent minus bounced
      - `bounced` integer: Prospects whose email bounced
      - `replied` integer: Prospects who replied
      - `positive_replies` integer
      - `meetings_booked` integer
      - `unsubscribed` integer
      - `opened` integer, nullable: null = not measured
      - `clicked` integer, nullable: null = not measured
      - `reply_rate` number, nullable: replied / contacted, percent
      - `bounce_rate` number, nullable: bounced / sent, percent
    - `steps` CampaignStep[]
      - `step` integer
      - `delay_days` integer
      - `subject` string, nullable
      - `scheduled` integer
      - `sent` integer
      - `pending` integer
      - `skipped` integer
      - `failed` integer

## Other responses

- `401`: Missing, wrong or revoked token (unauthorized)
- `403`: Missing scope (forbidden), paused account (account_inactive) or plan without the API (feature_not_enabled)
- `404`: No such campaign on this account (not_found)
- `429`: Rate limited (rate_limited, daily_limit). Wait Retry-After seconds.

---

[API](https://skmtc.dev/senders/apis/senders-rest-api.md) · [All operations](https://skmtc.dev/senders/apis/senders-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/senders/apis/senders-rest-api/revisions/3cd9960bc0af?raw)
