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

# List traced conversations

> Conversations that have spans in a window, newest first, with turn and error counts.

Lists the conversations that produced spans, one summary per conversation. Use it to find a conversation to inspect, then fetch its [spans](https://docs.poly.ai/api-reference/traces/endpoint/get-conversation-trace.md), [timeline](https://docs.poly.ai/api-reference/traces/endpoint/get-conversation-timeline.md) or a [single turn](https://docs.poly.ai/api-reference/traces/endpoint/get-conversation-turn.md).

## Request

### Headers

**X-API-KEY** `string` *required*

Account API key with read access to conversations.

### Query parameters

**project\_id** `string`

Restrict to one agent. Omit to list the whole account.

**from** `datetime`

Inclusive lower bound on the conversation's first turn, ISO 8601.

**to** `datetime`

Exclusive upper bound. Must be after `from`.

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

Conversations per page, 1–100.

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

Conversations to skip, 0–1000.

## Response

**conversations** `object[]`

**properties**

**conversation\_id** `string`

**project\_id** `string`

**first\_turn** `datetime`

Start of the first turn, UTC.

**last\_turn** `datetime`

Start of the last turn, UTC.

**turn\_count** `integer`

**error\_count** `integer`

Spans with status `Error` across the conversation.

**limit** `integer`

**offset** `integer`

**has\_more** `boolean`

## Example

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.us.poly.ai/api/v1/traces/conversations?project_id=PROJECT-V258TF29&from=2026-10-26T00:00:00Z&to=2026-10-28T00:00:00Z&limit=2" \
  -H "X-API-KEY: YOUR_API_KEY"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "conversations": [
    {
      "conversation_id": "CA3f2c1e9d6b7a4f8e9c0d1b2a3c4d5e6f",
      "project_id": "PROJECT-V258TF29",
      "first_turn": "2026-10-27T15:07:34.930309",
      "last_turn": "2026-10-27T15:07:35.680461",
      "turn_count": 2,
      "error_count": 0
    }
  ],
  "limit": 2,
  "offset": 0,
  "has_more": true
}
```

## Errors

| Status | Meaning |
| - | - |
| `400` | `from` is not before `to`. |
| `401` | Missing or invalid API key. |
| `403` | The key cannot read conversations. |
| `502` | The trace backend did not answer. |