---
title: "Get trace"
method: GET
path: "/traces/{trace_id}"
tags: ["Traces"]
---

# Get trace

`GET /traces/{trace_id}`

Loads a single trace with spans and stats.

## Path parameters

- `trace_id` string, required

## Response `200`

Trace details

- object
  - `id` string, required
  - `otel_trace_id` string, required
  - `project_id` string, required
  - `project_name` string
  - `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
  - `tool_calls` object[], required
    - `span_id` string, required
    - `name` string, required
    - `duration_ms` number, nullable, required
    - `is_error` boolean, required
  - `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
  - `total_duration_ms` number, nullable, required
  - `timestamp` string, date-time, required
  - `spans` object[], required
    - `id` string, required
    - `otel_span_id` string, required
    - `parent_otel_span_id` string, nullable, required
    - `name` string, required
    - `kind` string, nullable, required
    - `start_time_ns` string, nullable, required
    - `end_time_ns` string, nullable, required
    - `duration_ms` number, nullable, required
    - `status_code` string, nullable, required
    - `status_description` string, nullable, required
    - `input_tokens` number, nullable, required
    - `output_tokens` number, nullable, required
    - `model_name` string, nullable, required
    - `tps` number, nullable, required
    - `attributes` object
    - `events` unknown
  - `stats` object, required
    - `span_count` number, required
    - `total_tokens` number, nullable, required
    - `total_duration_ms` number, nullable, required
    - `error_count` number, required
    - `tool_calls` object[], required
      - `name` string, required
      - `otel_span_id` string, required
      - `status` string, nullable, required
    - `models_used` 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

## Other responses

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