Skip to main content
GET
/
api
/
v1
/
Account
/
{auth_id}
/
Call
List live calls
curl --request GET \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/Call \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
{
  "api_id": "c9527676-5839-11e1-86da-6ff39efcb949",
  "calls": [
    "eac94337-b1cd-499b-82d1-b39bca50dc31",
    "0a70a7fb-168e-4944-a846-4f3f4d2f96f1"
  ]
}
GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/?status=live
Returns an array of call UUIDs for all calls currently in progress on your account. Use this for a quick overview of active calls without fetching full call details.
Use this endpoint to monitor concurrent call volume or to get call UUIDs for batch operations like transfer or hangup.

​
Path parameters

ParameterTypeRequiredDescription
auth_idstringYesYour Vobiz account ID

​
Query parameters

ParameterTypeRequiredDescription
statusstringYesMust be set to live to retrieve only active calls

​
Example request

cURL
curl -X GET "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/?status=live" \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

​
Response

200 OK
{
  "api_id": "c9527676-5839-11e1-86da-6ff39efcb949",
  "calls": [
    "eac94337-b1cd-499b-82d1-b39bca50dc31",
    "0a70a7fb-168e-4944-a846-4f3f4d2f96f1"
  ]
}
FieldDescription
api_idUnique identifier for this API request
callsArray of call UUIDs for all active calls

​
Common 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.
Once you have the call UUIDs, use Retrieve a Live Call to get detailed information about each active call.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

Query Parameters

​
status
enum<string>
default:live
required
Available options:
live,
queued

Response

200 - application/json

List of live call UUIDs

​
api_id
string
required

Unique identifier for this API request

​
calls
string[]
required

Array of call UUIDs for all active calls