---
title: "Campaign send status"
method: GET
path: "/v1/campaigns/{id}/status"
tags: ["Campaigns"]
---

# Campaign send status

`GET /v1/campaigns/{id}/status`

## Request

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

Lightweight live send-state (running/paused/completed), schedule-window state, and headline metrics. Deep reporting lives under the analytics endpoints.

Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`.

## Path parameters

- `id` string, uuid, required

## Response `200`

- CampaignStatusApiDto
  - `id` string, uuid, required
  - `status` 'draft' | 'scheduled' | 'active' | 'paused' | 'stopped' | 'completed' | 'failed', required
  - `isWithinSchedule` boolean, required: Whether now is inside the sending window, for any status: within the campaign dates (not before `startDate`, not after the end of the `endDate` day in the campaign timezone) and inside the schedule (simple or advanced). A draft or paused campaign still does not send.
  - `nextScheduleOpensAt` string, date-time, nullable: When the campaign can next send (for any status): the next schedule window, or `startDate` itself when it falls inside a window. null when inside a window now, or when no window opens before the end of the `endDate` day.
  - `metrics` CampaignMetricsView, required
    - `leadsCount` number, required
    - `sent` number, required: Emails sent.
    - `opens` number, required: Open events.
    - `clicks` number, required: Click events.
    - `replies` number, required: Replies received.

## Other responses

- `400`: The request body or parameters failed validation.
- `401`: Missing or invalid API key.
- `403`: The key lacks a required scope, or the plan does not include API access.
- `404`: The resource does not exist in your workspace.
- `429`: Rate limit exceeded - retry after the interval in the Retry-After header.

---

[API](https://skmtc.dev/mailbeast/apis/mailbeast-public-api.md) · [All operations](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/revisions/6440ce0738a4?raw)