List campaigns

GEThttps://api.voice-agent.gowajee.ai/api/campaign/list

Returns all campaigns in your organization, newest first. There is no pagination.

Request

cURL

curl "https://api.voice-agent.gowajee.ai/api/campaign/list" -H "X-API-Key: $GOWAJEE_API_KEY"

JavaScript

const res = await fetch('https://api.voice-agent.gowajee.ai/api/campaign/list', {
  headers: { 'X-API-Key': process.env.GOWAJEE_API_KEY },
});
const { data: campaigns } = await res.json();

Python

campaigns = requests.get(
    "https://api.voice-agent.gowajee.ai/api/campaign/list",
    headers={"X-API-Key": os.environ["GOWAJEE_API_KEY"]},
    timeout=30,
).json()["data"]

Response

200 OK

{
  "success": true,
  "message": "Get Campaign list successfully",
  "data": [
    {
      "id": "eac2489c-672c-455e-ab8c-4e0ecd18d7dc",
      "name": "October payment reminder",
      "agentName": "Payment reminder",
      "status": "RUNNING",
      "numberOfRecipients": 1200,
      "numberOfCalledRecipients": 815,
      "numberOfCallingRecipients": 15,
      "numberOfNotStartedRecipients": 370,
      "createdAt": "2026-09-30T08:12:44.120Z",
      "updatedAt": "2026-10-01T02:00:05.310Z"
    }
  ]
}

data is an array of campaigns.

Each recipient is counted in exactly one of the three counters, so called + calling + not started = numberOfRecipients. In the example: 815 + 15 + 370 = 1200.

Field	Type	Description
id	string (UUID)	The campaign ID.
name	string	The campaign name.
agentName	string	The name of the agent that makes the calls. "" if the agent was deleted.
status	string	See Campaign status.
numberOfRecipients	integer	Total recipients.
numberOfCalledRecipients	integer	Recipients with at least one call that has ended or is being analyzed, and no call in progress right now. Someone waiting for a retry counts here. Calls that became EXPIRED or CANCELLED without being dialled also count here.
numberOfCallingRecipients	integer	Recipients with a call QUEUED, INITIATED, RINGING or IN_PROGRESS right now.
numberOfNotStartedRecipients	integer	Recipients whose only call is SCHEDULED, or who have no call yet.
createdAt / updatedAt	string (UTC)	Timestamps.