Skip to main content
GET
List campaigns
Requires campaigns:read. Filter with status=all|active|paused|draft|finished. Pagination uses page (default 1, maximum 100) and limit (default 20, maximum 100). The response contains campaigns and pagination. MCP’s cursor pagination is a separate interface.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Query Parameters

status
enum<string>
default:all

Filter by campaign status

Available options:
all,
active,
paused,
draft,
finished
page
number
default:1

Page number for pagination (1-indexed)

Required range: 1 <= x <= 100
limit
number
default:20

Maximum number of items to return

Required range: 1 <= x <= 100

Response

List of campaigns

campaigns
object[]
required

List of campaigns

pagination
object
required

Pagination info