Retrieve a Queued Call

Get details of a specific call that is currently queued and waiting to be connected.

This endpoint retrieves information about a call that has been initiated but is not yet connected. Queued calls are waiting for the destination to answer or for resources to become available.

What is a Queued Call? A call is in the "queued" state when it has been initiated via the API but hasn't been answered yet. This includes calls waiting for the destination to ring or answer.

Use Case: Monitor calls that are waiting to be connected, track queue times, or cancel calls before they connect if needed.

HTTP Request

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

Path Parameters

accountIdstringRequired

Your Vobiz account ID

callUuidstringRequired

Unique identifier of the queued call

Query Parameters

statusstringRequired

Must be set to "queued" to retrieve queued call details

Important: If the call is no longer queued (connected or ended), this endpoint will return a 404 error. Use the standard Retrieve a Call endpoint for completed calls.

Response

Returns the queued call object with basic call information.

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"
}

Response Fields

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

direction - Call direction ("outbound" or "inbound")

from - Source phone number

to - Destination phone number

caller_name - Caller ID name

Example Request

Retrieve Queued Call Status

Request

GET /api/v1/account/MA2025RK4E639VJFZAGV/call/6653422-91b6-4716-9fad-9463daaeeec2/?status=queued

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

Use Cases

•Monitor calls waiting to be connected
•Track queue times and identify slow connections
•Verify call details before connection completes
•Cancel queued calls if needed using the hangup endpoint
•Debug call initiation issues

Tip: Combine this with the Retrieve All Queued Calls endpoint to monitor all pending calls on your account at once.

Retrieve All Live Calls

Retrieve All Queued Calls