v1

latestOpenAPI 3.1.02026-07-2687120159.0 KB
Outbound Calls

Get the status of an outbound call

Retrieves the current status of an outbound call. Call status data is retained for approximately 2 hours after the call ends.

get/v1/agents/{agentId}/telephony/outbound-calls/{callSid}/status

Query parameters

environment'sandbox' | 'pre-release' | 'live' required

Target environment. Must match the environment used when triggering the call.

Response

Call status retrieved successfully.

callSidstring

The unique call identifier.

status'QUEUED' | 'CALLING' | 'SUCCESS' | 'FAILURE'

Current call status.

reasonstring

Human-readable reason for the current status. Typically populated for failure states; empty otherwise.

Example response

{
  "callSid": "OUT-550e8400-e29b-41d4-a716-446655440000",
  "status": "SUCCESS"
}