---
title: "Changes to Get the list of campaigns."
method: GET
path: "/api/external/v1/campaigns/get-list"
---

# Changes to Get the list of campaigns.

`GET /api/external/v1/campaigns/get-list`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-08-17** `dd3f47f72f7a` — 3 breaking, 1 warning, 3 info

## Changes

- **2026-08-17** `dd3f47f72f7a` — 3 breaking, 1 warning, 3 info
  - added the new required `query` request parameter `workspace_id`
  - removed the request body
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - removed the optional property `campaigns` from the response with the `200` status
  - api tag `GenPages` added
  - api tag `Campaigns` removed
  - added the non-success response with the status `403`

---

[Operation](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/docs/api/external/v1/campaigns/get-list/get.md) · [API](https://skmtc.dev/genpage/apis/genpage-external-api-documentation.md) · [Page](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/changes/api/external/v1/campaigns/get-list/get)