---
title: "Get a campaign"
method: GET
path: "/campaigns/{id}"
tags: ["Campaigns"]
---

# Get a campaign

`GET /campaigns/{id}`

## Request

- Base URL: `https://sending.dev/api/v1`
- URL: `https://sending.dev/api/v1/campaigns/{id}`
- Auth: HTTP bearer

Requires authentication only (any valid API key).

## Path parameters

- `id` string, required: Campaign ID.

## Response `200`

Campaign detail.

- object
  - `campaign` Campaign, required
    - `id` string, uuid, required
    - `name` string, required
    - `status` string, required
    - `listId` string, uuid, nullable
    - `segmentId` string, uuid, nullable
    - `scheduledAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `recipientCount` integer
    - `createdAt` string, date-time
    - `metrics` object, nullable: Only with `?metrics=1`; `null` for campaigns without messages.
      - `recipients` integer, required
      - `delivered` integer, required
      - `uniqueOpens` integer, required: Messages with at least one human open.
      - `uniqueClicks` integer, required
      - `contentClicks` integer, required
      - `unsubscribes` integer, required
      - `hardBounces` integer, required
      - `softBounces` integer, required
      - `openRate` number, nullable, required
      - `clickRate` number, nullable, required
      - `clickToOpenRate` number, nullable, required
      - `unsubscribeRate` number, nullable, required
      - `bounceRate` number, nullable, required

## Other responses

- `401`: Missing or invalid token.
- `404`: Resource not found.

---

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