Skip to main content
GET
/
v1
/
voice
/
campaigns
/
{campaign_id}
Get Campaign Status
curl --request GET \
  --url https://api.example.com/v1/voice/campaigns/{campaign_id} \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "campaign_id": "<string>",
  "status": "<string>",
  "progress": {
    "total": 123,
    "completed": 123,
    "pending": 123
  },
  "powered_by": "<string>"
}

​
Description

Returns the current status and progress of a specific voice campaign.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
campaign_id
string
required
The campaign identifier (e.g., "voice_campaign_abc123")

​
Response Fields

​
success
boolean
Whether the request was successful
​
campaign_id
string
Campaign identifier
​
status
string
Campaign status: active, paused, completed, ended
​
progress
object
Campaign progress details
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/voice/campaigns/voice_campaign_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "campaign_id": "voice_campaign_abc123",
  "status": "active",
  "progress": {
    "total": 100,
    "completed": 45,
    "pending": 55
  },
  "powered_by": "Teli"
}
404
{
  "error": "Campaign not found",
  "success": false,
  "powered_by": "Teli"
}

​
Campaign Statuses

StatusDescription
activeCampaign is currently making calls
pausedCampaign is temporarily paused
completedAll contacts have been called
endedCampaign has been manually ended