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

# List campaigns

`GET /Communications/Campaigns`

**Requires permission:** *CommunicationAdmin*

The caller's sent and scheduled communications, plus their department's, plus every campaign in the system for IT. Newest first.

## Response `200`

Success

- GetCampaignsResponse
  - `campaigns` Campaign[]
    - `id` integer
    - `subject` string, nullable
    - `bodyHtml` string, nullable
    - `linkTo` string, nullable
    - `borderColour` string, nullable
    - `interruptionLevel` integer
    - `sendPush` boolean
    - `sendEmail` boolean
    - `audience` string, nullable
    - `recipientCount` integer
    - `sentBy` string, nullable
    - `sentByDisplayName` string, nullable
    - `sentAt` string, date-time, nullable
    - `scheduledFor` string, date-time, nullable
    - `status` string
    - `recipientsJson` string, nullable
  - `departmentCampaigns` Campaign[]
    - `id` integer
    - `subject` string, nullable
    - `bodyHtml` string, nullable
    - `linkTo` string, nullable
    - `borderColour` string, nullable
    - `interruptionLevel` integer
    - `sendPush` boolean
    - `sendEmail` boolean
    - `audience` string, nullable
    - `recipientCount` integer
    - `sentBy` string, nullable
    - `sentByDisplayName` string, nullable
    - `sentAt` string, date-time, nullable
    - `scheduledFor` string, date-time, nullable
    - `status` string
    - `recipientsJson` string, nullable
  - `allCampaigns` Campaign[]
    - `id` integer
    - `subject` string, nullable
    - `bodyHtml` string, nullable
    - `linkTo` string, nullable
    - `borderColour` string, nullable
    - `interruptionLevel` integer
    - `sendPush` boolean
    - `sendEmail` boolean
    - `audience` string, nullable
    - `recipientCount` integer
    - `sentBy` string, nullable
    - `sentByDisplayName` string, nullable
    - `sentAt` string, date-time, nullable
    - `scheduledFor` string, date-time, nullable
    - `status` string
    - `recipientsJson` string, nullable
  - `department` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/28344aa564b4/schema)