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

# Trace list and tree

> List trace summaries and fetch the full span tree for a trace_id.

List trace summaries:

```http theme={null}
GET /api/v1/web/traces
```

| Parameter     | Required | Notes                                             |
| ------------- | -------- | ------------------------------------------------- |
| `from` / `to` | No       | Unix microseconds; defaults to the last 24 hours. |
| `q`           | No       | Free-text trace filter.                           |
| `filters`     | No       | JSON-encoded structured filters.                  |
| `limit`       | No       | Default 50; clamped to 1–200.                     |

The response contains `trace_id`, service, operation, start time, duration, span count, and error
count for each trace.

Fetch one trace tree:

```http theme={null}
GET /api/v1/web/trace/{trace_id}
```

The tree is limited to 100,000 spans and a 32 MiB response; `truncated=true` indicates the cap was
reached. Both endpoints require `streams.query`, or `sys.telemetry.read` in system scope.