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

Request

Base URL
https://api.us.poly.ai
Auth
API key in header X-API-KEY
TypeScript
https://skmtc.dev/poly/apis/polyai-agents-api/docs/v1/agents/:agentId/telephony/outbound-calls/:callSid/status/get.ts
A function with typed inputs. Its response is checked against the schema.

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

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

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.

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

No recorded changes to this operation across all 1 revision of this API.