On this page

GET/campaigns

List campaigns in the workspace. 0 credits. Rate class: global.

Request

GET /campaigns?limit=50
X-API-Key: sk_live_...

Query	Required	Notes
`status`	No	Exact campaign status string — see status values
`limit`	No	1–100, default 50
`cursor`	No	Opaque pagination cursor

Response

{
  "campaigns": [
    {
      "id": "search-xyz",
      "name": "Dentists in Austin",
      "status": "READY_TO_SEND",
      "totalLeads": 48,
      "assignedTemplateId": null,
      "stats": {
        "emailsSent": 0,
        "repliesReceived": 0,
        "replyRate": null
      }
    }
  ],
  "nextCursor": null
}

Field	Type
`id`	string
`name`	string
`status`	string
`totalLeads`	number
`assignedTemplateId`	string \| null
`stats.emailsSent`	number
`stats.repliesReceived`	number
`stats.replyRate`	number \| null

MCP

Tool: list_campaigns.