Retrieve All Audio Streams

This method lets you retrieve all active and inactive audio streams for a given call UUID.

Retrieve details of all audio streams (both active and inactive) for a specific call. This endpoint returns stream configuration, status, duration, and billing information.

Note: The response returns a single stream object with all stream details for the call.

HTTP Request

GEThttps://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Stream/

Authentication: Include X-Auth-ID and X-Auth-Token headers.

Arguments

No arguments need to be passed. All streams for the specified call will be returned.

Response

Returns the audio stream object with complete configuration details, timestamps, and billing information.

Response - 200 OK

{
  "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "audio_track": "both",
  "bidirectional": false,
  "bill_duration": 21,
  "billed_amount": "0.00300",
  "call_uuid": "call-uuid-xxxx-yyyy-zzzz-abcd",
  "created_at": "2025-11-14 02:44:50.617032+00:00",
  "end_time": "2025-11-14 08:14:50+05:30",
  "account_id": "MA_AABBCC",
  "resource_uri": "/v1/Account/MA_AABBCC/Call/call-uuid-xxxx-yyyy-zzzz-abcd/Stream/stream-id-aabbcc-ddeeff/",
  "rounded_bill_duration": 60,
  "service_url": "ws://yourapp.example.com/audiostream",
  "start_time": "2025-11-14 08:14:29+05:30",
  "stream_id": "stream-id-aabbcc-ddeeff"
}

Examples

cURL - Retrieve All Streams

cURL Request

curl -X GET https://api.vobiz.ai/api/v1/Account/MA_AABBCC/Call/call-uuid-xxxx-yyyy/Stream/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

Node.js Example

Node.js

const axios = require('axios');

const authId = 'MA_AABBCC';
const callUuid = 'call-uuid-xxxx-yyyy';

axios.get(`https://api.vobiz.ai/api/v1/Account/${authId}/Call/${callUuid}/Stream/`, {
  headers: {
    'X-Auth-ID': 'YOUR_AUTH_ID',
    'X-Auth-Token': 'YOUR_AUTH_TOKEN'
  }
})
.then(response => {
  const stream = response.data;

  console.log('Stream details:', stream);
  console.log(`Stream ID: ${stream.stream_id}`);
  console.log(`Audio Track: ${stream.audio_track}`);
  console.log(`Duration: ${stream.bill_duration} seconds`);
  console.log(`Cost: ${stream.billed_amount}`);
  console.log(`Status: ${stream.end_time ? 'Ended' : 'Active'}`);
})
.catch(error => {
  console.error('Error retrieving streams:', error.response.data);
});

Python Example

Python

import requests

auth_id = 'MA_AABBCC'
call_uuid = 'call-uuid-xxxx-yyyy'

url = f'https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Stream/'

headers = {
    'X-Auth-ID': 'YOUR_AUTH_ID',
    'X-Auth-Token': 'YOUR_AUTH_TOKEN'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    stream = response.json()

    print(f"Stream ID: {stream['stream_id']}")
    print(f"Service URL: {stream['service_url']}")
    print(f"Audio Track: {stream['audio_track']}")
    print(f"Duration: {stream['bill_duration']} seconds")
    print(f"Cost: {stream['billed_amount']}")

    status = 'Ended' if stream.get('end_time') else 'Active'
    print(f"Status: {status}")
else:
    print(f"Error: {response.status_code}")

Use Cases:

• Monitor stream status for a specific call
• Verify stream configuration and settings
• Check billing duration and costs
• Audit stream usage across your account
• Track whether a stream is active or has ended

Retrieve an Audio Stream

Stop an Audio Stream