---
title: "Get a trace and all its spans"
method: GET
path: "/api/traces/{trace_id}/"
tags: ["traces"]
---

# Get a trace and all its spans

`GET /api/traces/{trace_id}/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/traces/{trace_id}/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in cookie `sessionid`
  - API key in header `X-Api-Key`
  - HTTP bearer

Looked up by ``trace_id`` (the OTel 32-char hex), not by row id. Returns the root span plus every span sharing that ``trace_id``.

## Path parameters

- `trace_id` string, required

## Response `200`

- TraceDetail: ``GET /api/traces/{trace_id}/`` payload — root summary + every span.
  - `trace_id` string, required
  - `root` Span, required: Full span — used both for ``/api/traces/{trace_id}/`` (one span row in the per-trace list) and as the per-row representation for any span query.
    - `span_id` string, required
    - `trace_id` string, required
    - `parent_span_id` string, nullable, required
    - `is_root` boolean, required
    - `project` string, uuid, required
    - `span_type` string, required
    - `operation` string, required
    - `name` string, required
    - `kind` integer, required
    - `start_time_ns` integer, required
    - `end_time_ns` integer, required
    - `duration_ns` integer, required
    - `status_code` integer, required
    - `status_message` string, required
    - `error_details` TraceErrorDetails, required
      - `summary` string, required
      - `records` CapturedError[], required
        - `source` string, required
        - `type` string, required
        - `message` string, required
        - `stacktrace` string, required
      - `context` object, required
    - `service_name` string, required
    - `resource_attrs` unknown, required
    - `scope_name` string, required
    - `scope_version` string, required
    - `attributes` unknown, required
    - `input_attribute` string, nullable, required
    - `output_attribute` string, nullable, required
    - `events` unknown, required
    - `links` unknown, required
    - `capability` string, uuid, nullable, required
    - `conversation` string, uuid, nullable, required
    - `feedback_score` unknown, required
    - `eval_attributes` unknown, required
    - `received_at` string, date-time, required
  - `span_count` integer, required
  - `trace_status` 'completed' | 'live' | 'interrupted', required: * `completed` - completed * `live` - live * `interrupted` - interrupted
  - `usage` TraceUsage, required: One :func:`trace_usage_totals` bucket — the only usage rollup clients read.
    - `total_tokens` integer, nullable, required
    - `total_cost` number, double, nullable, required
    - `cache_read_tokens` integer, nullable, required
    - `model` string, nullable, required
  - `spans` Span[], required
    - `span_id` string, required
    - `trace_id` string, required
    - `parent_span_id` string, nullable, required
    - `is_root` boolean, required
    - `project` string, uuid, required
    - `span_type` string, required
    - `operation` string, required
    - `name` string, required
    - `kind` integer, required
    - `start_time_ns` integer, required
    - `end_time_ns` integer, required
    - `duration_ns` integer, required
    - `status_code` integer, required
    - `status_message` string, required
    - `error_details` TraceErrorDetails, required
      - `summary` string, required
      - `records` CapturedError[], required
        - `source` string, required
        - `type` string, required
        - `message` string, required
        - `stacktrace` string, required
      - `context` object, required
    - `service_name` string, required
    - `resource_attrs` unknown, required
    - `scope_name` string, required
    - `scope_version` string, required
    - `attributes` unknown, required
    - `input_attribute` string, nullable, required
    - `output_attribute` string, nullable, required
    - `events` unknown, required
    - `links` unknown, required
    - `capability` string, uuid, nullable, required
    - `conversation` string, uuid, nullable, required
    - `feedback_score` unknown, required
    - `eval_attributes` unknown, required
    - `received_at` string, date-time, required

---

[API](https://skmtc.dev/overmindlab/apis/overmind-api.md) - [All operations](https://skmtc.dev/overmindlab/apis/overmind-api/llms.txt) - [OpenAPI document](https://skmtc.dev/overmindlab/apis/overmind-api/revisions/0ecfd39e80c6?raw)