Skip to main content
GET
/
api
/
v1
/
Account
/
{auth_id}
/
Call
/
{call_uuid}
Retrieve a live call
curl --request GET \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid} \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
{
  "api_id": "c9cab827-d7e6-4ab8-b521-f29e593a1c26",
  "call_status": "in-progress",
  "call_uuid": "2ded13fe-4f9b-4958-9bfb-093ea2f29f91",
  "caller_name": "",
  "direction": "outbound",
  "from": "919262171438",
  "request_uuid": "2ded13fe-4f9b-4958-9bfb-093ea2f29f91",
  "session_start": "2026-06-11 16:03:28.586839",
  "stir_attestation": "Not Applicable",
  "stir_verification": "Not Applicable",
  "to": "919148227303"
}
GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/?status=live
Retrieve detailed information about an in-progress call. Unlike the standard CDR endpoint which returns finalized records, this endpoint provides real-time status for active calls including current state, call flow position, and live duration metrics.
This endpoint only returns data for calls currently in progress. For completed calls, use the standard call CDR endpoint instead.

​
Path parameters

ParameterTypeRequiredDescription
auth_idstringYesYour Vobiz account ID
call_uuidstringYesUnique identifier of the live call

​
Query parameters

ParameterTypeRequiredDescription
statusstringYesMust be live to retrieve real-time call information
The status=live query parameter is required. Without it, the endpoint returns the finalized CDR (if the call ended) or a 404 error.

​
Example request

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

​
Response

200 OK
{
  "api_id": "c9cab827-d7e6-4ab8-b521-f29e593a1c26",
  "call_status": "in-progress",
  "call_uuid": "2ded13fe-4f9b-4958-9bfb-093ea2f29f91",
  "caller_name": "",
  "direction": "outbound",
  "from": "919262171438",
  "request_uuid": "2ded13fe-4f9b-4958-9bfb-093ea2f29f91",
  "session_start": "2026-06-11 16:03:28.586839",
  "stir_attestation": "Not Applicable",
  "stir_verification": "Not Applicable",
  "to": "919148227303"
}

​
Response fields

FieldDescription
api_idUnique identifier for this API request
call_statusCurrent state of the call (e.g. in-progress)
call_uuidUnique identifier of the live call
caller_nameCaller ID name, if available (empty string otherwise)
directionCall direction: inbound or outbound
fromOriginating number
request_uuidIdentifier of the request that initiated the call
session_startTimestamp when the call session started
stir_attestationSTIR/SHAKEN attestation level, or Not Applicable
stir_verificationSTIR/SHAKEN verification result, or Not Applicable
toDestination number
Poll this endpoint periodically to track a call’s status while it is in progress.

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"

​
call_uuid
string
required
Example:

"cdr_XXXXXXXXXX"

Query Parameters

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

Response

200 - application/json

Live call details

​
api_id
string
required

Unique identifier for this API request

​
call_status
string
required

Current state of the call (e.g. in-progress)

​
call_uuid
string
required
​
caller_name
string
required
​
direction
string
required
​
from
string
required
​
request_uuid
string
required
​
session_start
string
required
​
stir_attestation
string
required
​
stir_verification
string
required
​
to
string
required