Skip to content
Overmind
Get started
API Reference
Traces

List traces (root spans)

traces.list(TraceListParams**kwargs) -> TraceListResponse
GET/api/traces/

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

ParametersExpand Collapse
agent: Optional[str]
formatuuid
duration_ns_gte: Optional[int]
duration_ns_lte: Optional[int]
has_error: Optional[bool]
iteration: Optional[str]
formatuuid
job: Optional[str]
formatuuid
kind: Optional[int]
max_duration_ms: Optional[float]
min_duration_ms: Optional[float]
name: Optional[str]
operation: Optional[str]
ordering: Optional[str]

Which field to use when ordering the results.

page: Optional[int]

A page number within the paginated result set.

project: Optional[str]
formatuuid
received_at_gte: Optional[Union[str, datetime]]
formatdate-time
received_at_lte: Optional[Union[str, datetime]]
formatdate-time
service_name: Optional[str]
service_name_in: Optional[SequenceNotStr[str]]

Multiple values may be separated by commas.

span_id: Optional[str]
span_type: Optional[Literal["llm_call", "tool_call"]]
  • llm_call - Llm Call
  • tool_call - Tool Call
Accepts one of the following:
"llm_call"
"tool_call"
start_time_ns_gte: Optional[int]
start_time_ns_lte: Optional[int]
status_code: Optional[int]
trace_id: Optional[str]
ReturnsExpand Collapse
class TraceListResponse: …
count: int
results: List[Result]
agent: Optional[str]
formatuuid
duration_ns: int
end_time_ns: int
iteration: Optional[str]
formatuuid
job: Optional[str]
formatuuid
kind: int
name: str
operation: str
project: str
formatuuid
received_at: datetime
formatdate-time
service_name: str
span_id: str
span_type: Literal["llm_call", "tool_call"]
  • llm_call - Llm Call
  • tool_call - Tool Call
Accepts one of the following:
"llm_call"
"tool_call"
start_time_ns: int
status_code: int
status_message: str
trace_id: str
List traces (root spans)
from overmind_lab import OvermindLab

client = OvermindLab()
traces = client.traces.list()
print(traces.count)
{
  "count": 123,
  "results": [
    {
      "agent": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "duration_ns": 0,
      "end_time_ns": 0,
      "iteration": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "job": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "kind": 0,
      "name": "name",
      "operation": "operation",
      "project": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "received_at": "2019-12-27T18:11:19.117Z",
      "service_name": "service_name",
      "span_id": "span_id",
      "span_type": "llm_call",
      "start_time_ns": 0,
      "status_code": 0,
      "status_message": "status_message",
      "trace_id": "trace_id"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}
Returns Examples
{
  "count": 123,
  "results": [
    {
      "agent": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "duration_ns": 0,
      "end_time_ns": 0,
      "iteration": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "job": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "kind": 0,
      "name": "name",
      "operation": "operation",
      "project": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "received_at": "2019-12-27T18:11:19.117Z",
      "service_name": "service_name",
      "span_id": "span_id",
      "span_type": "llm_call",
      "start_time_ns": 0,
      "status_code": 0,
      "status_message": "status_message",
      "trace_id": "trace_id"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}