Skip to main content

GET /v1/campaigns

GET/v1/campaigns
scope: campaigns.read 0 credits

List campaigns with statistics.

Campaign-whitelisted keys: filtered, not 403

If the API key has a campaign whitelist (campaign_ids set), this endpoint simply filters the list to the whitelisted campaigns instead of returning an error. Other campaign-bound endpoints (replies, sends, approvals) return 403 campaign_scope_denied for anything outside the whitelist. An explicit ?campaign_id= outside the whitelist also returns 403 campaign_scope_denied where that filter is supported.

Query params: status (active|paused|completed), client_id (filter by client workspace — scoped keys: must match key scope or 403), limit (default 50, max 100), offset

Try it​

GET/v1/campaigns
Saved locally in your browser
Query Parameters
active · paused · completed
Max 100
URLhttps://slazbvfvliieskvkjtav.supabase.co/functions/v1/api-gateway/v1/campaigns

Enter your API key above to send requests

Response​

{
  "campaigns": [{
    "id": "abc-123",
    "name": "Q1 SaaS Outreach",
    "status": "active",
    "sent": 500,
    "replied": 47,
    "reply_rate": 9.4,
    "open_rate": 64.0,
    "client": { "id": "client-456", "name": "Agency Client A" },
    "stats_last_synced_at": "2026-03-20T12:00:00Z"
  }],
  "count": 5,
  "total_count": 23,
  "has_more": false
}