---
title: "Campaigns with stats, newest first"
method: GET
path: "/campaigns"
tags: ["Campaigns"]
---

# Campaigns with stats, newest first

`GET /campaigns`

## Request

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

Scope: campaigns:read. Archived campaigns only with status=archived. Stats refresh at most once a minute.

## Query parameters

- `limit` integer
- `cursor` string
- `order` 'desc' | 'asc'
- `status` 'active' | 'paused' | 'completed' | 'archived'

## Response `200`

OK

- object
  - `data` Campaign[], 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
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid parameter (bad_request)
- `401`: Missing, wrong or revoked token (unauthorized)
- `403`: Missing scope (forbidden), paused account (account_inactive) or plan without the API (feature_not_enabled)
- `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)