---
title: "GET /v1/campaigns"
method: GET
path: "/v1/campaigns"
---

# GET /v1/campaigns

`GET /v1/campaigns`

## Query parameters

- `page` string — Page number for pagination (default: 1)
- `status` 'DRAFT' | 'SCHEDULED' | 'RUNNING' | 'PAUSED' | 'SENT' — Filter campaigns by status
- `search` string — Search campaigns by name or subject

## Response `200`

Get list of campaigns

- object
  - `campaigns` object[], required
    - `id` string, required
    - `name` string, required
    - `from` string, required
    - `subject` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `status` string, required
    - `scheduledAt` string, date-time, nullable, required
    - `total` integer, required
    - `sent` integer, required
    - `delivered` integer, required
    - `unsubscribed` integer, required
  - `totalPage` integer, required

## Changes

- **2026-07-17** `ee7832fe66a6` — 1 breaking, 5 info
  - for the `query` request parameter `page`, default value `1` was removed
  - removed the `DRAFT` enum value from the `campaigns/items/status` response property for the response status `200`
  - removed the `PAUSED` enum value from the `campaigns/items/status` response property for the response status `200`
  - removed the `RUNNING` enum value from the `campaigns/items/status` response property for the response status `200`
  - …2 more
- **2026-03-03** `8088d55e5f7c` — 3 breaking, 5 warning, 2 info
  - removed the enum value `CANCELLED` from the `query` request parameter `status`
  - removed the enum value `COMPLETED` from the `query` request parameter `status`
  - removed the enum value `IN_PROGRESS` from the `query` request parameter `status`
  - added the new `DRAFT` enum value to the `campaigns/items/status` response property for the response status `200`
  - …6 more
- **2026-02-16** `9c8bc00f6436` — 1 info
  - endpoint added
- **2026-01-17** `da09bf6f14b1` — 1 breaking
  - api removed without deprecation
- **2026-01-10** `07328ce64525` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/usesend/apis/usesend-api/changes/v1/campaigns/get.md)

---

[API](https://skmtc.dev/usesend/apis/usesend-api.md) · [All operations](https://skmtc.dev/usesend/apis/usesend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usesend/usesend-api/revisions/ee7832fe66a6/schema)