---
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`

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.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)