---
title: "Get the status of an outbound call"
method: GET
path: "/v1/agents/{agentId}/telephony/outbound-calls/{callSid}/status"
tags: ["Outbound Calls"]
---

# Get the status of an outbound call

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

## Request

- Base URL: `https://api.us.poly.ai`
- URL: `https://api.us.poly.ai/v1/agents/{agentId}/telephony/outbound-calls/{callSid}/status`
- 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)

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

## Query parameters

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

## Response `200`

Call status retrieved successfully.

- OutboundCallStatusResponse
  - `callSid` string: The unique call identifier.
  - `status` 'QUEUED' | 'CALLING' | 'SUCCESS' | 'FAILURE': Current call status.
  - `reason` string: Human-readable reason for the current status. Typically populated for failure states; empty otherwise.

## Other responses

- `400`: Invalid parameters — missing environment, invalid call SID, or no connector found.
- `401`: Unauthorized — missing or invalid API key.
- `403`: Forbidden — insufficient permissions.
- `502`: Outbound calling service unavailable. Retry with exponential backoff.

---

[API](https://skmtc.dev/poly/apis/polyai-agents-api.md) - [All operations](https://skmtc.dev/poly/apis/polyai-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/poly/apis/polyai-agents-api/revisions/76f3c606e395?raw)