---
title: "Search traces"
method: GET
path: "/traces/search"
tags: ["Traces"]
---

# Search traces

`GET /traces/search`

Search traces with structural and behavioral filters.

## Query parameters

- `project_id` string, required
- `query` string
- `tool_name` string
- `model` string
- `agent_name` string
- `status` string
- `error_only` boolean
- `start` string
- `end` string
- `min_spans` string
- `max_spans` string
- `min_duration_ms` string
- `max_duration_ms` string
- `min_tokens` string
- `min_thread_traces` string
- `max_thread_traces` string
- `attribute_filters` string
- `limit` integer

## Response `200`

Search results

- object[]
  - `id` string, required
  - `otel_trace_id` string, required
  - `project_id` string, required
  - `service_name` string, nullable, required
  - `timestamp` string, date-time, required
  - `issue_extraction` object, nullable, required
    - `status` 'running' | 'completed' | 'skipped' | 'failed', required
    - `reason` 'issues_found' | 'no_issues_found' | 'no_spans' | 'unsupported_trace' | 'error' | 'null', nullable, required
    - `issue_count` number, nullable, required
    - `occurrence_count` number, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `error_message` string, nullable

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.dev/uselemma/apis/lemma-platform-api.md) · [All operations](https://skmtc.dev/uselemma/apis/lemma-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uselemma/lemma-platform-api/revisions/5242165d7015/schema)