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

# Query Traces

> Execute observability query DSL against canonical traces

```json theme={null}
{
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "filters": [
    {"field": "status", "op": "eq", "value": "failed"},
    {"field": "q", "op": "contains", "value": "timeout"}
  ],
  "limit": 50,
  "offset": 0,
  "order_by": "started_at",
  "order_dir": "desc"
}
```