---
title: "List every campaign for the account with id, name, status, and event counts."
method: GET
path: "/campaigns"
tags: ["campaigns"]
---

# List every campaign for the account with id, name, status, and event counts.

`GET /campaigns`

## Request

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

No N+1: one query for the campaign rows, one GROUP BY for every campaign's event counts. A campaign with zero events still reports zero-filled counts (never missing keys).

## Response `200`

Campaign list.

- CampaignListItem[]
  - `campaignId` string, required
  - `name` string, required
  - `status` string, required
  - `counts` EventCounts, required
    - `sent` integer, required
    - `reply` integer, required
    - `bounce` integer, required: HARD (permanent 5.x.x) bounces.
    - `complaint` integer, required
    - `unsubscribe` integer, required
    - `failed` integer, required
    - `soft_bounce` integer, required: SOFT (transient 4.x.x) bounces — tallied, not a permanent suppression.
    - `auto_reply` integer, required: Automatic replies (out-of-office and the like), recognized from the message's headers. Not replies: never counted in reply, replied, replyRate or positiveReplies; they never stop a sequence or fire the reply webhook.

## Other responses

- `401`: Missing, invalid, or inactive bearer token.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)