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

# List Calls

`GET /v1/calls`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/calls`
- Auth: HTTP bearer

List voice calls made by your AI agents.

Returns call history with optional filters by agent or status.
Each entry includes direction (inbound/outbound), duration,
phone numbers, and current status.

Filters:
  - agent_id: only calls for a specific AI agent
  - status: "initiated", "in-progress", "completed", or "failed"

## Query parameters

- `agent_id` string, nullable: Only calls handled by this agent (agt_... from list_agents). Omit for every agent on the account.
- `status` string, nullable: Only calls in this exact status, e.g. 'completed' or 'failed'. Other statuses: 'initiated', 'in-progress', 'busy', 'no-answer', 'canceled'.
- `limit` integer: Page size: how many calls to return, newest first.
- `offset` integer: How many calls to skip, to page past earlier results.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)