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

# List campaigns

`GET /campaigns`

## Request

- Base URL: `https://www.creatorriver.com/api/v1`
- URL: `https://www.creatorriver.com/api/v1/campaigns`
- Auth: HTTP bearer

Lists your campaigns with their brief, status and how many creators are at each stage. Free. Every account has a default “General Outreach” campaign you can use when no specific campaign fits.

## Query parameters

- `status` 'draft' | 'active' | 'paused' | 'closed': Only campaigns with this status
- `page` integer: Page number, from 1
- `limit` integer: How many to return, 1-100 (default 20)

## Response `200`

Success

- object
  - `data` unknown, required

## Other responses

- `4XX`: Failure; `error.code` says what to do
- `5XX`: Failure; `error.code` says what to do

---

[API](https://skmtc.dev/creatorriver/apis/creator-river-api.md) · [All operations](https://skmtc.dev/creatorriver/apis/creator-river-api/llms.txt) · [OpenAPI document](https://skmtc.dev/creatorriver/apis/creator-river-api/revisions/d3707b18785c?raw)