Skip to main content
GET
/
v1
/
voice
/
campaigns
List Voice Campaigns
curl --request GET \
  --url https://api.example.com/v1/voice/campaigns \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "campaigns": [
    {
      "campaign_id": "<string>",
      "status": "<string>",
      "voice_agent_id": "<string>",
      "agent_id": "<string>",
      "contacts_count": 123,
      "organization_id": "<string>",
      "tenant_id": "<string>",
      "campaign_begin_time": {},
      "campaign_end_time": {},
      "created_at": {}
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all voice campaigns (bulk calling campaigns) for an organization filtered by tenant.

​
Authentication

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

​
Query Parameters

​
organization_id
string
required
Organization unique_id
​
tenant_id
string
required
Tenant identifier
​
is_admin
boolean
default:"false"
If true, returns all org campaigns. If false, returns only user’s campaigns.

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of campaigns
​
campaigns
array
Array of voice campaign objects
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/voice/campaigns?organization_id=1762896364768x389173798861431550&tenant_id=your_tenant&is_admin=false" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 1,
  "campaigns": [
    {
      "campaign_id": "vc 1",
      "status": "completed",
      "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "contacts_count": 1,
      "organization_id": "1762896364768x389173798861431550",
      "tenant_id": "your_tenant",
      "campaign_begin_time": "2025-11-20T19:44:46.536728",
      "campaign_end_time": "2025-11-27T19:44:46.536728",
      "created_at": ""
    }
  ],
  "powered_by": "Teli"
}
400 (Missing Organization ID)
{
  "error": "organization_id required",
  "success": false,
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list voice campaigns",
  "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

​
Notes

  • Voice campaigns make automated calls to contact lists
  • Uses Teli Voice agents for AI-powered conversations
  • Supports pause/resume/end operations
  • Admin users see all org campaigns, regular users see filtered view
  • Campaigns are scoped by tenant_id for multi-tenant isolation