---
title: "List Calls"
method: GET
path: "/api/v1/calls/"
tags: ["Call Management", "Call Management"]
---

# List Calls

`GET /api/v1/calls/`

Retrieve a paginated list of calls with optional filtering.
    
    Supports:
    - Pagination with page and limit parameters
    - Filtering by call status
    - Sorting by creation time (newest first)

## Query parameters

- `page` integer — Page number (1-based)
- `limit` integer — Number of items per page (1-100)
- `status_filter` 'initiating' | 'ringing' | 'connected' | 'on_hold' | 'disconnected' | 'failed', nullable — Filter calls by status

## Response `200`

Calls retrieved successfully

- CallListResponse — Response model for listing calls.
  - `calls` CallStatusResponse[], required — List of calls
    - `call_id` string, required — Unique call identifier
    - `status` 'initiating' | 'ringing' | 'connected' | 'on_hold' | 'disconnected' | 'failed', required — Current call status
    - `duration` integer, nullable — Call duration in seconds (null if not connected)
    - `participants` object[] — List of call participants
    - `events` object[] — Recent call events
  - `total` integer, required — Total number of calls matching criteria
  - `page` integer — Current page number (1-based)
  - `limit` integer — Number of items per page

## Other responses

- `400` — Invalid pagination parameters
- `422` — Validation Error

---

[API](https://skmtc.net/azure/apis/real-time-voice-agent-api.md) · [All operations](https://skmtc.net/azure/apis/real-time-voice-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/real-time-voice-agent-api/versions/3e24c76dccd5/schema)