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

# List campaigns

`GET /campaigns`

Paginated list of the shop's creator campaigns with status/type filters and sortable columns. Returns counts per status tab (`all/active/past/draft`) and per type (retainer/challenge/leaderboard).

## Query parameters

- `page` integer
- `page_size` integer
- `status` string, nullable — UI alias: 'active' (= published), 'past' (= ended), 'draft' (= unpublished drafts), or 'archived'.
- `campaign_type` 'retainer' | 'challenge' | 'leaderboard' | 'live_gmv_challenge' | 'race' | 'bingo' | 'sweepstakes' — Supported campaign types.
- `search` string, nullable
- `date_from` string, nullable — YYYY-MM-DD; start_date >= date_from
- `date_to` string, nullable — YYYY-MM-DD; end_date <= date_to
- `sort_by` string, nullable — campaign_name | campaign_type | gmv | start_date | end_date | total_posts | total_views | created_at
- `sort_order` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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