Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
telephony
/
outbound-calls
/
{callSid}
/
status
Get the status of an outbound call
curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/telephony/outbound-calls/{callSid}/status \
  --header 'X-API-KEY: <api-key>'
{
  "callSid": "OUT-550e8400-e29b-41d4-a716-446655440000",
  "status": "SUCCESS",
  "reason": ""
}

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
agentId
string
required
​
callSid
string
required

The unique call identifier returned from the trigger endpoint (prefixed with OUT-).

Query Parameters

​
environment
enum<string>
required

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

Available options:
sandbox,
pre-release,
live

Response

Call status retrieved successfully.

​
callSid
string

The unique call identifier.

Example:

"OUT-550e8400-e29b-41d4-a716-446655440000"

​
status
enum<string>

Current call status.

Available options:
QUEUED,
CALLING,
SUCCESS,
FAILURE
Example:

"SUCCESS"

​
reason
string

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

Example:

""

Last modified on June 29, 2026