Retrieve All Live Calls

Get a list of all ongoing call UUIDs for your account.

This endpoint returns an array of call UUIDs for all calls that are currently in progress on your account. This is useful for getting a quick overview of active calls without fetching full call details.

Use Case: Use this endpoint to monitor the number of concurrent calls on your account or to get a list of call UUIDs for batch operations.

HTTP Request

GET/api/v1/account/{accountId}/call/?status=live

Path Parameters

accountIdstringRequired

Your Vobiz account ID

Query Parameters

statusstringRequired

Must be set to "live" to retrieve ongoing calls

Important: The status=live query parameter is required to filter for active calls only.

Response

Returns an array of call UUIDs for all ongoing calls.

Response - 200 OK

{
  "api_id": "c9527676-5839-11e1-86da-6ff39efcb949",
  "calls": [
    "eac94337-b1cd-499b-82d1-b39bca50dc31",
    "0a70a7fb-168e-4944-a846-4f3f4d2f96f1"
  ]
}

Response Fields

api_id - Unique identifier for this API request

calls - Array of call UUIDs for all active calls

Example Request

Retrieve All Active Calls

Request

GET /api/v1/account/MA2025RK4E639VJFZAGV/call/?status=live

Headers:
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"
Content-Type: application/json

Use Cases

•Monitor concurrent call volume in real-time
•Build live dashboards showing active call count
•Implement call capacity alerts and monitoring
•Get call UUIDs for batch operations (transfer, hangup)
•Audit active calls for compliance or troubleshooting

Next Step: Once you have the call UUIDs, you can use them with other endpoints like Retrieve a Live Call to get detailed information about each active call.

Retrieve a Live Call

Retrieve a Queued Call