---
title: "List campaigns"
method: GET
path: "/campaigns"
tags: ["Campaigns"]
---

# List campaigns

`GET /campaigns`

## Request

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

Returns up to 100 campaigns of the workspace. With `?metrics=1` every row carries a summary of results (delivered, human opens, clicks, rates) computed in a single query. Requires authentication only (any valid API key).

## Query parameters

- `metrics` string: `1` to include `metrics` on every campaign.

## Response `200`

Campaign list.

- CampaignList
  - `campaigns` 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.

---

[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)