---
title: "List dashboard traces"
method: GET
path: "/traces/dashboard"
tags: ["Traces"]
---

# List dashboard traces

`GET /traces/dashboard`

Returns dashboard-ready traces for a project.

## Query parameters

- `project_id` string, required
- `limit` integer
- `cursor` string
- `agent_name` string
- `sort` string
- `status` 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

## Response `200`

Dashboard traces

- object
  - `data` object[], required
    - `id` string, required
    - `otel_trace_id` string, required
    - `project_id` string, required
    - `service_name` string, nullable, required
    - `agent_name` string, nullable, required
    - `thread_id` string, nullable, required
    - `thread_trace_count` number, nullable, required
    - `agent_input` unknown
    - `agent_input_display` string, nullable, required
    - `agent_output` unknown
    - `interaction` object, required
      - `has_input` boolean, required
      - `has_output` boolean, required
      - `input_kind` 'none' | 'text' | 'structured', required
      - `has_user_message_tools` boolean, required
    - `has_error` boolean, required
    - `has_occurrences` boolean, required
    - `span_count` number, required
    - `total_duration_ms` number, nullable, required
    - `timestamp` string, 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
  - `total` number, required
  - `next_cursor` object, nullable, required
    - `timestamp` string, required
    - `id` string, required
    - `span_count` number
    - `total_duration_ms` number, 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)