GET /agents/active-calls — Calls in Progress

Returns every call currently in progress across your workspace. No agent ID, no phone number, no request body — one request tells you what is live.

GET https://<your-region-host>/api/v1/agents/active-calls

Request

Header	Value
`X-API-Key`	Your VoiceInfra API key

cURL

curl -X GET "https://<your-region-host>/api/v1/agents/active-calls" \
  -H "X-API-Key: vk_YOUR_API_KEY"

Response

With calls in progress

{
  "active_call_count": 2,
  "active_calls": [
    {
      "id": "sip-ob-call-+14155551234-a1b2c3",
      "call_type": "dynamic-outbound",
      "to_number": "+14155551234",
      "from_number": "+18005559876",
      "participant_count": 2
    },
    {
      "id": "sip-ib-call-_+442071234567_d4e5f6",
      "call_type": "inbound",
      "to_number": "+18005559876",
      "from_number": "+442071234567",
      "participant_count": 2
    }
  ]
}

No calls in progress

{
  "active_call_count": 0,
  "active_calls": []
}

Field	Type	Meaning
`active_call_count`	integer	How many calls are live right now
`active_calls`	array	One entry per live call
`id`	string	Identifier for the call
`call_type`	string	`inbound`, `outbound`, or `dynamic-outbound`
`to_number`	string or null	The number being called
`from_number`	string or null	The caller’s number
`participant_count`	integer	Participants on the call

This reflects calls in progress. A call that has ended leaves the list, and its record appears in your call log instead.

What to use it for

Webhook fallback

If a call_completed webhook does not arrive — a client disconnect, a delivery failure — poll this endpoint to find out whether the call actually ended.

Sequential calls

Running a chain of outbound calls? Check here before placing the next one, so two calls never overlap.

Capacity planning

Check how many calls are live before starting a batch, so you stay within your concurrent call allowance.

Your own dashboard

Build a live view in your own tooling showing active calls, their direction, and participants.

Polling for completion

The most common pattern: place a call, wait for the webhook, and fall back to polling if it doesn’t arrive.

POST /api/v1/outbound_call { ... }     → store call_id
await call_completed webhook           → done
  ↳ no webhook within your window?
    GET /api/v1/agents/active-calls    → is it still running?

Errors

Status	Cause
`401`	Missing or invalid API key
`500`	Server error — retry with backoff

Overview

Endpoints

MCP & Apps

GET /agents/active-calls — Calls in Progress

Request

Response

What to use it for

Webhook fallback

Sequential calls

Capacity planning

Your own dashboard

Polling for completion

Errors

​Request

​Response

​What to use it for

Webhook fallback

Sequential calls

Capacity planning

Your own dashboard

​Polling for completion

​Errors

Request

Response

What to use it for

Polling for completion

Errors