---
title: "List traces (root spans)"
method: GET
path: "/api/traces/"
tags: ["traces"]
---

# List traces (root spans)

`GET /api/traces/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/traces/`
- 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

Returns one row per trace — the root span (``parent_span_id IS NULL``) of each trace the caller can see.

## Query parameters

- `all_spans` boolean
- `capability` string, uuid
- `conversation` string, uuid
- `duration_ns__gte` integer
- `duration_ns__lte` integer
- `has_error` boolean
- `has_model` boolean
- `kind` integer
- `max_duration_ms` number
- `min_duration_ms` number
- `model` string
- `name` string
- `operation` string
- `ordering` string
- `page` integer
- `page_size` integer
- `project` string, uuid
- `project_id` number
- `received_at__gte` string, date-time
- `received_at__lte` string, date-time
- `search` string
- `service_name` string
- `service_name__in` string[]
- `session` string, uuid
- `signal_event` string, uuid
- `span_id` string
- `span_type` string
- `start_time_ns__gte` integer
- `start_time_ns__lte` integer
- `status_code` integer
- `total_cost__gte` number
- `total_cost__lte` number
- `total_tokens__gte` number
- `total_tokens__lte` number
- `trace_id` string
- `unbound` boolean

## Response `200`

- PaginatedRootSpanListList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` RootSpanList[], required
    - `trace_id` string, required
    - `span_id` string, required
    - `project` string, uuid, required
    - `capability` string, uuid, nullable, required
    - `capability_name` string, nullable, required
    - `span_type` string, required
    - `operation` string, required
    - `name` string, required
    - `service_name` string, required
    - `kind` integer, required
    - `status_code` integer, required
    - `status_message` string, required
    - `error_summary` string, nullable, required
    - `start_time_ns` integer, required
    - `end_time_ns` integer, required
    - `duration_ns` integer, required
    - `total_tokens` integer, nullable, required
    - `total_cost` number, double, nullable, required
    - `cache_read_tokens` integer, nullable, required
    - `model` string, nullable, required
    - `conversation` string, uuid, nullable, required
    - `feedback_score` unknown, required
    - `received_at` string, date-time, required
    - `source` string, required
    - `eval_attributes` unknown, required
    - `trace_status` 'completed' | 'live' | 'interrupted', required: * `completed` - completed * `live` - live * `interrupted` - interrupted

---

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