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

# Semantic search traces

`GET /traces/semantic-search`

Search traces by semantic similarity over embedded trace summaries.

## Query parameters

- `project_id` string, required
- `query` string
- `tool_name` string
- `model` string
- `error_only` boolean
- `start` string
- `end` string
- `limit` integer

## Response `200`

Semantic 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
  - `summary` string, required
  - `similarity` number, required

## 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)