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

# List calls

`GET /v1/calls`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/calls`
- Auth: HTTP bearer

List calls in this workspace, newest first. Supports filtering by `agent_id`, `status` (queued/active/completed/failed/canceled) and `direction` (outbound/inbound). Use `limit` and `offset` for pagination. To retrieve full call details (transcript, recording), call `GET /v1/calls/{id}` for a specific call.

## Query parameters

- `agent_id` string, nullable: Filter by agent.
- `status` string, nullable: Filter by status: queued, active, completed, failed, canceled.
- `direction` string, nullable: Filter by direction: outbound or inbound.
- `limit` integer: Page size.
- `offset` integer: Pagination offset.

## Response `200`

Paginated list of calls with summary fields.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)