> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Calls

> Call history for your workspace, with filters and paging

List calls in your workspace, newest first. Each item has the same fields as [Get call](https://docs.60db.ai/api-reference/agents/get-call.md).

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Query Parameters

**agent\_id** `string`

Only calls made by this agent (UUID)

**status** `string`

`queued`, `dialing`, `in_progress`, `completed` or `failed`

**direction** `string`

`outbound` or `inbound`. Inbound calls are coming soon

**from** `string`

Start of a date range, ISO 8601 (for example `2026-11-01`). Not a phone number

**to** `string`

End of a date range, ISO 8601. Not a phone number

**limit** `integer` (default: 50)

1–100

**offset** `integer` (default: 0)

For pagination

Filters that are not valid (an unknown `status`, or a `from` or `to` that is not a date) are ignored.

## Response

**200 OK**

```json theme={null}
{
  "success": true,
  "data": {
    "calls": [
      {
        "id": "6b1f0c52-4d7e-4b8a-9d3e-2a1c8e7f0a11",
        "agent_id": "9c2e1d7a-0b3f-4e6a-8f1d-5a7b9c0e2d44",
        "agent_name": "Front desk",
        "phone_line_id": "2d8e4f10-6a3b-4c9d-8e7f-0b1a2c3d4e5f",
        "direction": "outbound",
        "to": "+919999999999",
        "from": "+919876543210",
        "status": "completed",
        "reason": null,
        "duration_secs": 62,
        "started_at": "2026-11-03T10:16:30.000Z",
        "connected_at": "2026-11-03T10:16:38.000Z",
        "ended_at": "2026-11-03T10:17:40.000Z",
        "record": true,
        "has_recording": true,
        "has_transcript": true,
        "summary": { "turns": 6, "tool_calls": 1, "tool_failures": 0 },
        "cost": { "runtime_usd": 0, "runtime_billing_status": "skipped" },
        "source": "api",
        "metadata": { "crm_lead_id": "L-1042" },
        "created_at": "2026-11-03T10:16:30.000Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}
```

## Errors

No endpoint-specific errors. Access and permission errors are listed in [Agents](https://docs.60db.ai/features/agents.md#errors).

## Example

```bash cURL theme={null}
curl "https://api.60db.ai/agents/calls?agent_id=AGENT_ID&status=completed&limit=20" \
  -H "Authorization: Bearer your-api-key"
```

```javascript JavaScript theme={null}
const { calls } = await client.agents.calls.list({ agentId, status: 'completed', limit: 20 });
```

```python Python theme={null}
result = client.agents.calls.list(agent_id=agent_id, status="completed", limit=20)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.