Call Management
Retrieve a queued call
Fetch details of a single pending Vobiz call by UUID before it connects - inspect destination, timestamps, and queue state via GET with status=queued.
GET
/
api
/
v1
/
Account
/
{auth_id}
/
Call
/
{call_uuid}
/
Retrieve a queued 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>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"api_id": "45223222-74f8-11e1-8ea7-12313806be9a",
"call_status": "queued",
"call_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
"request_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
"caller_name": "+15856338537",
"direction": "outbound",
"from": "15856338537",
"to": "14154290945"
}GET https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/?status=queued
A call is in the “queued” state when it has been initiated via the API but has not been answered yet, including calls waiting for the destination to ring or answer.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
auth_id | string | Yes | Your Vobiz account ID |
call_uuid | string | Yes | Unique identifier of the queued call |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Must be queued to retrieve queued call details |
If the call is no longer queued (connected or ended), this endpoint returns a 404 error. Use the standard CDR endpoint for completed calls.
Example request
cURL
curl -X GET "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/?status=queued" \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
Response
200 OK
{
"direction": "outbound",
"from": "15856338537",
"call_status": "queued",
"api_id": "45223222-74f8-11e1-8ea7-12313806be9a",
"to": "14154290945",
"caller_name": "+15856338537",
"call_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
"request_uuid": "6653422-91b6-4716-9fad-9463daaeeec2"
}
| Field | Description |
|---|---|
api_id | Unique identifier for this API request |
call_status | Always queued for this endpoint |
call_uuid | Unique identifier for the call |
request_uuid | Request identifier (same as call_uuid) |
direction | Call direction: outbound or inbound |
from | Source phone number |
to | Destination phone number |
caller_name | Caller ID name |
Combine this endpoint with Retrieve All Queued Calls to monitor all pending calls on your account at once.
Authorizations
Path Parameters
Was this page helpful?
⌘I
Retrieve a queued 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>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"api_id": "45223222-74f8-11e1-8ea7-12313806be9a",
"call_status": "queued",
"call_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
"request_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
"caller_name": "+15856338537",
"direction": "outbound",
"from": "15856338537",
"to": "14154290945"
}