> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vaanivoice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Campaign Status

> Get current status and progress for a campaign

## Get Campaign Status

Return the current status and progress counters for a campaign.

***

## Path Parameters

<ParamField path="campaign_id" type="string" required>
  UUID of the campaign
</ParamField>

***

## Example Request

```bash theme={null}
curl "https://api.vaani.ai/api/campaigns/abc-123-xyz/status" \
  -H "X-API-Key: vaani_abc123..."
```

***

## Response `200 OK`

```json theme={null}
{
  "id": "abc-123-xyz",
  "campaign_name": "Summer Promo 2024",
  "campaign_status": "active",
  "call_concurrency": 3,
  "days_of_week": "monday,tuesday,wednesday,thursday,friday",
  "time_range_from": "07:30:00Z",
  "time_range_to": "13:30:00Z",
  "max_retries": 3,
  "retry_after_mins": 30,
  "agent": {
    "id": "agent-456",
    "name": "Sales Agent"
  },
  "total_leads": 1000,
  "completed_calls": 523,
  "pending_calls": 477,
  "failed_calls": 12,
  "created_at": "2026-07-01T10:30:00Z",
  "updated_at": "2026-07-01T14:22:15Z",
  "stats": {
    "total_calls": 523,
    "completed": 498,
    "pending": 477,
    "in_progress": 3,
    "failed": 12
  }
}
```

***

## Response Fields

<ResponseField name="campaign_status" type="string">
  Current status: `scheduled`, `active`, `paused`, `paused_out_of_range`, `completed`, `cancelled`
</ResponseField>

<ResponseField name="time_range_from" type="string">
  Daily calling window start time (UTC with Z suffix)
</ResponseField>

<ResponseField name="time_range_to" type="string">
  Daily calling window end time (UTC with Z suffix)
</ResponseField>

<ResponseField name="stats" type="object">
  Real-time call statistics for the campaign
</ResponseField>